India Company Diligence

india-company-diligence

一个开源 MCP 服务，让 Agent 能读懂印度上市公司的公开数据： 完整的 MCA 公司主数据本地镜像（约 374 万家公司）、离线 CIN 解码和 GSTIN 验证，并为每个字段提供来源信息。

v0.1.0 · 镜像截至日期 2026-10-25 · 上游数据集更新于 2026-10-13 · MIT 许可证 · github.com/amit043/india-company-diligence

60 秒演示

你： 一家名为 “Hella Infra Market” 的供应商想要一笔 2 亿卢比的信用额度。帮我查查他们的情况。

Claude (调用 company_search，然后调用 company_lookup)：HELLA INFRA MARKET LIMITED（CIN U46632MH2016PLC283737）状态为 Active，是一家在孟买 ROC 注册的非上市公众公司，成立于 2016-07-15，实缴资本为 285.8 亿卢比。注意：一家名称相似的实体 HELLA INFRACON PRIVATE LIMITED 状态为 Strike Off，请在发票上确认准确的 CIN。缺失信息：董事、抵押和财务数据需要实时 MCA 层（路线图）。来源：mca-master-data，截至日期 2026-10-25。

每个回答都会说明各字段的来源、缺失内容和过时信息。 缺失信息会明确标出，不会编造。

安装并运行（Claude Desktop）

需要 uv。

# 1. one-time: download the prebuilt mirror (~530 MB download, ~1.4 GB on disk)
uvx --from india-company-diligence icd-fetch

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "india-company-diligence": {
      "command": "uvx",
      "args": ["india-company-diligence"],
      "env": { "ICD_MIRROR_DB": "C:\\full\\path\\to\\mca_mirror.duckdb" }
    }
  }
}

重启 Claude Desktop。询问：“查询 CIN L17110MH1973PLC019786”。

工具

工具	功能	网络
company_lookup(cin)	查询单个 CIN 的完整注册记录，并提供各字段的来源信息	仅镜像
company_search(name, limit)	按名称进行不区分大小写的搜索，最多 50 条结果，按相关度排序	仅镜像
cin_decode(cin)	离线结构解码：上市状态、州、年份、公司类型	无
gstin_validate(gstin)	离线验证 GSTIN 结构和 mod-36 校验和	无

来源信息约定

每个工具都会返回数据及其来源信息，并说明缺失或过时的内容—— 绝不编造，也不会返回错误页面：

{
  "data": { "...": "..." },
  "provenance": [{"field": "CompanyStatus", "source": "mca-master-data", "as_of": "2026-10-25"}],
  "missing": ["director_network (live layer unavailable)"],
  "stale": []
}

数据与归属

公司主数据（按 RoC 划分），由印度公司事务部通过 data.gov.in 发布，采用 印度政府开放数据许可证（GODL）授权。 共 3,738,721 家公司；上游数据集更新于 2026-10-13；本镜像构建于 2026-10-25。

gstin_validate 按设计仅支持离线运行：目前没有无需密钥即可使用的公开 GST API，因此法定名称 / 注册状态会标记为 missing，而不是猜测。

路线图

• L1 实时层 — 通过浏览器自动化获取 MCA 董事和抵押信息（第 2 周）
• LLP 解码 — cin_decode 目前支持公司 CIN；接下来支持 LLP ID（例如 ABA-1729）
• 更新频率：随上游数据更新，每月重建镜像

发现错误或数据缺失：提交问题。

自行同步镜像（作为 icd-fetch 的替代方案）

在 data.gov.in 获取免费的 API 密钥，然后：

export OGD_API_KEY=your-key        # or put it in a .env file at the repo root
uv run icd-sync                    # paginated pull, checkpointed, safe to interrupt
uv run icd-import                  # CSV -> data/mca_mirror.duckdb, source/as_of baked in

拉取过程会控制请求频率（默认每页间隔 5 秒；可通过 OGD_DELAY_SECONDS 或 uv run icd-sync --delay 3 覆盖）。完成比速度重要。

暂停与恢复

• 停止：uv run icd-watch stop（或直接关闭终端）
• 状态：uv run icd-watch status
• 恢复：uv run icd-watch start — 从 data/mca_master.checkpoint 继续
• 检查点达到数据集总数后，运行 uv run icd-import

开发

uv sync
uv run pytest
uv run ruff check .

偏好使用普通 pip？requirements.txt / requirements-dev.txt 中列出了相同的依赖。

许可证

MIT。数据采用 GODL-India 许可证；归属信息如上。