Abn Lookup

@pipeworx/abn-lookup

自带密钥（BYOK）。澳大利亚商业登记处查询：将 ABN 或 ACN 解析为注册法定实体名称、实体类型、ABN 状态、GST 注册情况、地址州/邮编和商业名称，或按实体名称/商业名称搜索登记信息。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1872+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其认可，也未由其发布。

工具

• abn_lookup(abn, _apiKey) — ABN -> 法定名称、实体类型、状态、GST、地址、商业名称。
• abn_search(name, state?, maxResults?, _apiKey) — 实体名称/商业名称 -> 排序后的 ABN 匹配结果。
• acn_lookup(acn, _apiKey) — ACN（公司编号）-> 与 abn_lookup 相同的详细信息。

身份验证

仅支持自带密钥。平台不提供密钥。每次调用都需要调用方通过 _apiKey 提供自己的 ABR Web 服务 GUID。可在 https://abr.business.gov.au/Tools/WebServices 免费注册——ABR 要求用户在注册身份下接受其 Web 服务协议（条款及个人信息共享确认）后，才会通过电子邮件发送 GUID；这需要用户本人同意，因此 Pipeworx 不会持有或代为提供 GUID。

如果未提供 _apiKey，每个工具都会拒绝调用，并提示“requires an API key”，同时提供上述注册网址。

数据源

• https://abr.business.gov.au/json/AbnDetails.aspx — ABN 或 ACN 详细信息。
• https://abr.business.gov.au/json/AcnDetails.aspx — ACN 详细信息。
• https://abr.business.gov.au/json/MatchingNames.aspx — 名称搜索。

注意事项

• JSON 端点采用 JSONP：响应正文会包装为 <callback>(...)，其中 <callback> 取决于发送的 callback= 查询参数（经实时验证，省略时默认为 callback）。此工具包会按函数名通用地移除包装，而不是将 callback 硬编码。
• 无效或无法识别的 GUID 会返回 HTTP 200，其中所有核心字段均为空，并带有 Message 字符串（例如 "The GUID entered is not recognised as a Registered Party"），而非 HTTP 错误。ABR 对真实的未找到结果也使用相同结构，因此仅凭响应无法区分“核心字段为空且带有 Message”是密钥被拒，还是确实未找到——此工具包会在错误信息中明确说明这一点，而不会猜测。
• 映射输出中的字段名（Abn、AbnStatus、EntityName、BusinessName[] 等）来自 ABR 发布的 JSON 示例网址；由于不存在 fleet GUID（BYOK，已于 2026-09-03 核实），成功查询时填充的字段结构尚未经过端到端验证。始终会将原始 ABR 负载作为 raw 返回，因此持有真实密钥的调用方不会受此处过时字段名的影响。
• abn_search 中的 state 是客户端对 ABR 返回的匹配结果进行的筛选（根据每条匹配结果的 State 字段），并非 ABR 文档所述的查询参数——ABR 的公开 JSON 示例文档未显示 MatchingNames.aspx 支持州筛选参数。

快速开始

添加到 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "abn-lookup": {
      "url": "https://gateway.pipeworx.io/abn-lookup/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/abn-lookup/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出该工具包自身的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天情况的权威依据。

这是有意设计的，并非意外的多路复用。元工具让限定范围的连接也能回答此工具包未涵盖的问题——通过 ask_pipeworx 在整个目录中路由——而无需添加第二个 MCP 服务。目前无法挂载不含这些工具的工具包端点；如果额外的架构定义占用的上下文比路由带来的收益更多，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是此工具包的：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和同一组 1872+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

此工具包需要你自己的 API 密钥（_apiKey）——我们不会为它代理 API 密钥，因此没有无需密钥即可运行的 curl 命令。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/abn_lookup。查找工具：向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求，内容为 {"query":"..."}。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

{
  "mcpServers": {
    "abn-lookup": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-abn-lookup"]
    }
  }
}

或者直接运行它，确认其可以启动：

npx -y @pipeworx/mcp-abn-lookup

它通过 stdin/stdout 使用 MCP 协议，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上述网关连接额外提供的任何共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的语言提问，而不是直接调用工具——此功能既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Abn Lookup data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT