先回答：你需要公司資料，還是某份申報文件？
搜尋「香港公司 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，可以查看樣本及文件解析服務。
參考來源
文中的清單和例子可幫你準備材料；核對官方表格內容時，請留意所引文件的版本。