Simplified Chinese developer onboarding

一个标识符输入，一条来源绑定证据输出。

下面两条路径使用已经上线的 CivicDataForge 产品：一个已支持美国辖区的物业地址，或一个印度公司 CIN。调用方使用自己的 Apify 账户与 Token；同步接口返回数据集行，可直接读取来源、范围、观察时间与 SHA-256 凭证。

先试美国物业地址先试印度 CIN读取机器清单
Token 规则：只把自己的 Apify Token 放在 Authorization: Bearer 请求头中。不要把 Token 写进 URL、网页、Git 仓库、聊天记录或公开示例。下方命令中的 $APIFY_TOKEN 是本地环境变量占位符。

路径一：美国物业地址 → STR 许可证据凭证

这个小范围示例向 Orlando 官方发布源查询一个地址。地址模式一次只选择一个已支持辖区，可提交 1–25 个地址，并对完整的所选发布源查询作出证据状态。

复制运行

curl -sS -X POST \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "outputMode": "address_evidence",
    "cities": ["orlando"],
    "addresses": ["1100 Briercliff Drive, Orlando, FL"]
  }' \
  "https://api.apify.com/v2/actors/civicdataforge~str-permit-registry/run-sync-get-dataset-items?timeout=120"

如果本机有 jq，可在命令末尾追加：

| jq '.[0] | {
  decision,
  scope_completeness,
  observed_at,
  source_url,
  decision_receipt_hash
}'
decision：EVIDENCE_FOUND、NO_PUBLISHED_MATCH、REVIEW_REQUIRED 或 SCOPE_INCOMPLETE。
scope_completeness：说明是否完成所选发布源查询。
source_url 与 observed_at：绑定来源和本次观察时间。
decision_receipt_hash：绑定输入、范围、结果和匹配记录的 SHA-256 凭证。
美国地址边界：NO_PUBLISHED_MATCH 只表示在完整的所选发布源查询中没有精确地址匹配；它不证明该物业违法、不合格，也不证明所有政府系统都没有记录。来源无法完整评估时，产品不得制造否定结论。

路径二：印度 CIN → 公司主数据证据凭证

这个示例用公开公司标识符 L17110MH1973PLC019786 进行精确 CIN 查询，并要求 GLEIF 只接受 registeredAs 的精确标识符匹配。

复制运行

curl -sS -X POST \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cin": "L17110MH1973PLC019786",
    "includeLei": true,
    "maxRecords": 1
  }' \
  "https://api.apify.com/v2/actors/civicdataforge~india-company-registry/run-sync-get-dataset-items?timeout=120"

如果本机有 jq，可在命令末尾追加：

| jq '.[0] | {
  evidence_decision,
  cin,
  company_name,
  source_status,
  source_freshness,
  record_fingerprint,
  evidence_decision_receipt_hash
}'
evidence_decision：区分找到证据、需要复核、无发布匹配、来源不可用和范围不完整。
source_status 与 source_freshness：把来源状态、目录更新时间、发布者覆盖截止日和本次读取时间分开。
record_fingerprint：对稳定的官方源记录内容计算 SHA-256。
evidence_decision_receipt_hash：绑定选择器、来源、范围、观察时间和结果的 SHA-256 凭证。
印度 CIN 边界：当前数据来自印度政府 OGD 平台上的 MCA 公司主数据资源。目录显示月度粒度和较新的目录更新时间，但发布者备注仍写明底层数据截至 2023-11-03。因此，本次成功读取不等于实时 MCA 状态，也不包含完整董事、抵押、申报或财务报表。

通过 MCP 接入 Agent

美国房产证据 MCP

https://mcp.apify.com/?tools=civicdataforge/str-permit-registry,civicdataforge/fl-dbpr-vacation-rentals,civicdataforge/property-violations

连接和实际运行使用调用方自己的 Apify 身份验证。

印度公司证据 MCP

https://mcp.apify.com/?tools=civicdataforge/india-company-registry

印度 Actor 不放进七工具默认网关，避免默认工具列表膨胀；需要时单独加载。

托管 MCP 请求同样使用 Authorization: Bearer YOUR_APIFY_TOKEN。连接方式以 Apify MCP 官方文档 和客户端的安全 Header/Secret 配置为准。

从样本走向生产

  1. 先运行一个地址或 CIN，确认输出字段和证据边界符合用途。
  2. 在扩量前检查 source-health.json 与 reliability.json。
  3. 大批量或长任务改用异步 /runs 端点，保存响应中的运行 ID 与数据集 ID，再读取调用方自己的数据集。
  4. 美国物业需要人工复核时，可选择 99 美元 Permit Evidence Audit；验证价值后再进入监控。

机器发现入口

简体中文开发者 JSON

两条标识符工作流、REST/MCP 入口、凭证字段和边界。

全局 API Catalog

当前产品、覆盖、MCP 组和证据合同。

.well-known 发现清单

人类、搜索、Agent 和机器入口的稳定索引。

完整 AI 发现指南

产品用途、商业路径和责任边界。

中国本地数据边界：本页面向使用中文的跨境开发者，销售的是现有美国房产证据和印度公司证据。CivicDataForge 当前没有中国企业登记数据库、GSXT 批量 API 或中国本地官方记录产品，也不会绕过实名、验证码或反爬虫控制。