cn-company-qcc-enrichment

Enriches Chinese company lists with legal representative, registration phone, address, and status via Qichacha MCP.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill cn-company-qcc-enrichment-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cn-company-qcc-enrichment
Source: https://github.com/CHENHUI-X/toolbox/tree/main/codex-skill/codex/cn-company-qcc-enrichment
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill cn-company-qcc-enrichment-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openpyxl, and includes scripts (resource) and references (resource) components.

What problem does it solve? Daily batches of 10-50 Chinese company names arrive with missing fields (legal representative, registered phone, address, operating status, business exceptions), and manually looking each one up is slow and error-prone. This Skill provides a repeatable methodology and scripts to enrich those lists within the free daily Qichacha MCP credit quota and deliver a standardized Excel file. ## Core Features & Use Cases - Authoritative field enrichment via Qichacha MCP: Batch scripts call get_company_registration_info, get_contact_info, and get_business_exception to fill legal representative, registration phone, address, status, and exception reasons from an authoritative source. - Quota-aware daily workflow: A top-up script resumes unfinished companies the next day using the daily 100 free credits (about 11 companies per day), stopping automatically on error code 300008. - Supplementary contact search and merge: Free browser channels (Baidu PC, Sogou WeChat) fill extra phone numbers, and merge_deliver.py produces the standardized Excel with a data-source column. - Use Case: Each morning you receive an Excel with 30 new company names; run extract_names.py, then qcc_mcp_batch.py for the first 11, queue the rest for top-up, supplement phones via browser search, and deliver the merged Excel. ## Quick Start Give the AI today's company list Excel and ask it to enrich legal representative, contact phone, registered address, and exception status using the Qichacha MCP workflow, then deliver the standardized result Excel.

Frequently Asked Questions about cn-company-qcc-enrichment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch enrich Chinese company information with Qichacha MCP?

Extract company names from the Excel with extract_names.py, then run qcc_mcp_batch.py with the name list and an index range. The script calls registration, contact, and business-exception tools per company and saves results as JSON every 10 companies.

How many companies can Qichacha MCP free credits query per day?

The free daily quota is 100 credits, and a complete per-company query (registration, contact, exception) costs about 9 credits, so roughly 11 companies per day. Remaining companies go into a pending list and are continued the next day by qcc_mcp_topup.py.

Which fields must come from an authoritative source like Qichacha?

Legal representative, legal representative contact phone, operating status, and the confirmed no-exception conclusion must come from Qichacha MCP or an equivalent authoritative source. Supplementary phones can come from web search, and the business-scope field must stay empty.

What happens when Qichacha MCP credits run out mid-batch?

The API returns error code 300008, and qcc_mcp_topup.py stops immediately to avoid wasted calls. Unfinished companies stay in the cumulative JSON and are resumed the next day when the daily 100 credits refresh.

Can I use the national GSXT system for free bulk company lookups instead?

No, gsxt.gov.cn blocks bulk access with HTTP 521 challenges and per-IP rate limits, making it unsuitable for batch enrichment. Qichacha MCP is the only tested working authoritative source in this workflow, with Tianyancha as an unverified backup.