mrc-data

Official Python SDK for MRC Data -- China's apparel supply chain API.

Access 1,000+ verified suppliers, 350+ fabric specifications, and 170+ industrial clusters across China, each enriched with independent lab measurements (AATCC, ISO, GB).

Installation

pip install mrc-data

Quick start

from mrc_data import MRCData

client = MRCData(api_key="your-api-key")

# Search suppliers in Guangzhou
suppliers = client.search_suppliers(city="Guangzhou", certification="BSCI")

# Get supplier details
detail = client.get_supplier_detail("sup_abc123")

# Search fabrics by composition
fabrics = client.search_fabrics(composition="cotton", weight_min=150)

# Compare industrial clusters
comparison = client.compare_clusters(ids=["cls_humen", "cls_shaoxing"])

# Detect specification discrepancies
result = client.detect_discrepancy(supplier_id="sup_abc123", fabric_id="fab_xyz")

# Database statistics
stats = client.get_stats()

Async usage

import asyncio
from mrc_data import AsyncMRCData

async def main():
    async with AsyncMRCData(api_key="your-api-key") as client:
        suppliers = await client.search_suppliers(province="Guangdong")
        fabrics = await client.search_fabrics(weave="twill")
        print(suppliers)

asyncio.run(main())

API methods

Error handling

from mrc_data import MRCData, AuthenticationError, NotFoundError, RateLimitError

client = MRCData(api_key="your-api-key")

try:
    detail = client.get_supplier_detail("sup_invalid")
except AuthenticationError:
    print("Check your API key")
except NotFoundError:
    print("Supplier not found")
except RateLimitError:
    print("Slow down -- rate limit exceeded")

Configuration

client = MRCData(
    api_key="your-api-key",
    base_url="https://api.meacheal.ai",  # default
    timeout=60.0,                         # seconds, default 30
)

Both MRCData and AsyncMRCData support context managers for automatic cleanup of the underlying HTTP connection pool.

License

MIT