先回答：你需要公司资料，还是某份申报文件？
搜索“香港公司 API”，你可能只是想找一个地址，也可能需要一份周年申报表，或想把表内数据整理成 Excel。这几件事看似接近，所需来源却不同。先想清楚最后想收到什么，再看工具能否提供，会比只比较它能不能返回 JSON 更容易选对。
如果只需要某数据集所载的名称和地址，开放数据查询可能已经能够回答；如果要求“2024 年某个结算日期的 NAR1 原文及其中信息”，就需要那份文件。格式相同不代表来源相同：一份公司清单 JSON 与一份从指定 PDF 提取的 JSON，不能因为都能导入系统就互相替代。
读完这篇指南，你可以带着几个具体问题去比较工具：我要查哪家公司、需要哪份文件、工具还缺什么来源，以及能否先试一个自己看得懂的例子。即使你不写代码，也可以用这些问题与开发者或服务商沟通。
官方开放数据接口：看懂它实际提供的范围
这里讨论的是公司注册处在 DATA.GOV.HK 发布的仍在登记册上的本地公司注册办事处地址数据及其 API 说明，不是公司注册处全部数据与服务的总称，不应推广为所有历史、已解散或非香港公司的数据。该数据集标示每日更新，接口提供公司名称或 BRN 查询以及 JSON、CSV、XML 输出；具体查询方式和字段应以链接中的官方说明为准。
“每日更新”描述数据集的更新安排，不会让查询结果自动带上所需的历史申报 PDF，也不能把某个地址的查询时间当作 NAR1 的结算日期。评估时逐项阅读数据集的公司覆盖范围、字段说明和更新信息；需求中没有被列出的信息，先记为缺口，不要期待 AI 根据名称或地址推算。
完整需求示例：一项工作需要哪些来源？
虚构需求：“为示例甲公司补齐供应商档案。公司主体由采购确认；需要结算日期为 2024 年 8 月 2 日的 NAR1 PDF，另整理文件内的公司名称、地址和股本；保留来源页码。已有一个旧公司编号，但尚未核实 BRN。输出先供人阅读，再由数据同事确认是否导入。”这段需求已经把查公司和读文件分开。
下面是需求与来源的对照，不是某款工具的功能表。每行都应能回答“依据什么交付”。如果工具只回答了第一行，即使返回很完整的 JSON，也不能把其余三行标成完成。反过来，如果手上已有指定 PDF，也不必为了使用 API 而重新安排取件。
左右滑动查看完整表格；键盘可聚焦表格后使用方向键。
| 需要交付 | 需要的来源或确认 | 仍要核对 |
|---|---|---|
| 确认是哪家公司 | 原需求、公司识别信息及需求人确认 | 相近名称和旧编号是否已厘清 |
| 指定日期 NAR1 PDF | 所选申报文件的影像 | 文种、公司及表内结算日期 |
| 文件内名称、地址和股本 | 指定 PDF 中实际包含的页面 | 结果能够追溯原文；缺页不猜值 |
| 可供导入的结果 | 已确认字段和目标示例 | 接收者试用，内容另核对 |
输入质量：不要在查询前把识别码改错
先保存用户原来提供的名称、编号和编号标签。如果来源写 CR No.，不能只为符合工具字段名称就把它改叫 BRN。香港唯一业务识别码安排使用商业登记号码作为识别码；历史公司编号与 BRN 的关系，应通过官方对照途径核对，不要把一串数字直接搬到另一个标签下。
没有结果时，先记录使用了什么输入、查询了哪个来源以及当时的响应，再判断下一步。一次没有匹配可能需要重新核对名称或识别信息，不能直接变成“公司不存在”。如果返回多个候选，也应交回需求人选定；让模型挑选最像的一条，只是把尚未解决的问题藏起来。
决策案例：三种工具都能输出 JSON，选哪个？
以下是完全虚构的候选工具。A 只查询公开地址数据；B 能交付选定 PDF，但不解析；C 可以接受你提供的 PDF 并整理字段，但不取件。它们不是本站能力清单，也不是对真实供应商的评价。请回到上面的供应商档案需求：哪个工具单独使用就能交出全部结果？
答案是没有一个。A 可以协助其覆盖范围内的信息查询，但不能代替指定文件。B 解决原文件，C 解决原文件之后的整理；两者能否衔接，要核对文件是否可以交接、文种是否在范围内以及如何验收。如果原本已经持有正确 PDF，C 才可能是需要评估的主要步骤。
这个例子也说明为什么不能只比较“每次 API 调用多少钱”。调用 A 十次不等于获取十份文件；重复获取同一个 PDF 也不等于更新公司信息。应比较完成同一项需求需要的工作、来源与人工确认，而不是一个看起来最便宜的请求单价。
先试一份你能亲自核对的文件
先不用交出整批文件。找一份公开样本，或一份你有权使用的 PDF，说清楚你会提供什么、允许工具查询哪些来源、希望收到什么，以及缺少信息时应该怎样回复。用一个自己能核对的小例子，更容易看出工具是否适合你的工作；不过，单次试用仍不足以推算整体准确率。
至少加入一个“无法直接完成”的情境，例如只有旧公司编号、只有两页节选却询问董事，或者要求尚未提供的文件。合适的回复应指出缺口和下一步，不应把相近公司的信息、其他年份的文件或猜测值填进去。记录实际输入与输出，让同事能够重复这次检查。
- 来源：能指出实际使用的数据集或文件吗？
- 范围：是否把未提供的信息当成确定答案？
- 交付：接收者能否找到所需信息并追溯来源？
- 异常：问题由谁确认，是否留下未完成事项？
先想清楚要做什么，再选 MCP 或 CLI
MCP 和 CLI 是不同的使用方式，背后仍要有合适的数据来源。你可以直接问服务商：“我要的这份文件能获取吗？需要我提供什么？遇到同名公司或缺页，会怎样处理？”能让 AI 调用的工具，也不一定能获取你需要的每份申报文件。
想试用 ClariRecord MCP 或 CLI？请联系我们，说明你的任务、公司或文件数量、已有材料和目标格式，我们会与你确认试用范围和接入安排。也可加入候补名单。如需整理 PDF，可以查看样本及文件解析服务。
参考来源
文中的清单和例子可以帮你准备材料；核对官方表格内容时，请留意引用文件的版本。