文档

连接 Brreg 并投入使用

所需了解的一切:如何连接、助手获得的工具、数据来源、使用限制以及个人信息的处理方式。

连接

Brreg 是一个远程 MCP 服务器。您的助手连接到一个地址,您使用 Publifye 账户登录。访问权限仅通过该登录授予,无需创建、复制或轮换任何 API 密钥。

https://brreg.publifye.com/mcp

访问需在您的 Publifye 账户中开通 Brreg 套餐。 查看套餐

网页版 Claude 和 Claude Desktop

  1. 打开设置(Settings),然后进入连接器(Connectors)。
  2. 选择添加自定义连接器(Add custom connector),将其命名为 Brreg,并粘贴上方的地址。
  3. 选择连接(Connect),使用您的 Publifye 账户登录,然后批准访问权限。
  4. 在对话中,确认工具菜单(tools menu)下的 Brreg 已启用,即可开始提问。

Claude Code

添加一次服务器,然后在 Claude Code 中运行 /mcp 进行登录:

claude mcp add --transport http brreg https://brreg.publifye.com/mcp

其他 MCP 客户端

传输协议
上述地址提供 Streamable HTTP(基于 POST 的 JSON-RPC)。
登录
通过 Publifye 登录进行认证,采用 OAuth 2.1 与 PKCE。客户端会自动注册(动态客户端注册),因此无需提前进行任何配置。
发现机制
https://brreg.publifye.com/.well-known/oauth-protected-resource

工具

以下是连接后助手获得的工具,直接取自线上服务器。所有工具都只读取数据。

entity_lookup

按组织编号查询单个或多个组织,并返回其登记记录。仅在您明确要求时才提供关键财务数据。

  • compact
  • cursor
  • fields
  • include_subunits
  • live
  • max_bytes
  • orgnr
  • orgnrs
  • snapshot_id

entity_resolve

将公司名称(包括原用名称)转换为候选组织及其编号,不会擅自为您做出选择。

  • name
  • compact
  • cursor
  • fields
  • include_deleted
  • kind
  • limit
  • max_bytes
  • municipality
  • public_body
  • snapshot_id

entity_structure

展示各组织之间的隶属关系:上级组织、下属单位,以及公共机构下属的机构。

  • orgnr
  • compact
  • cursor
  • fields
  • limit
  • max_bytes
  • section
  • snapshot_id

code_list

列出可用于筛选的各类代码,例如组织形式、行业和市镇。

  • list
  • compact
  • cursor
  • fields
  • limit
  • max_bytes
  • query
  • snapshot_id

snapshot_status

说明登记册数据的更新程度:上次从 Brønnøysundregistrene 获取数据的时间。

  • detail

搜索指定地点附近

向 entity_search 提供中心点和半径(lat、lon 和 radius_km),即可列出注册地址位于该距离范围内的组织,按距离由近到远排序,并附带各自的距离和地址点位。若包含名称查询,排序仍按相关性排列,半径仅作为筛选条件。

  • 单独使用时半径上限为 10 km,与组织形式、行业或名称等其他筛选条件配合使用时上限可达 50 km。
  • 该点位是注册地址对应的 Kartverket 地址点位——主体单位为经营地址,下属单位为所在地址。它并非建筑物轮廓,也未必是实际开展业务的地点。
  • 以 c/o 形式填写的地址、邮政信箱、境外地址以及无法与地址登记册匹配的地址均无点位,也不会出现在半径搜索中。
  • 许多组织共用同一个地址(例如会计师事务所)。每个搜索结果都会注明有多少个组织共用该点位。
entity_search lat=60.3913 lon=5.3221 radius_km=2 org_form=["KIRK"]

数据与来源

Enhetsregisteret
来自 Brønnøysundregistrene 的主体单位与下属单位数据,每周基于完整登记册重新构建。当某项记录从开放数据中移除时,将在 24 小时内从 Brreg 中清除。
Regnskapsregisteret
来自最新呈交年度财务报表的关键财务数据,仅在您明确要求时提取,并始终注明所属年份。
Kartverket 地址点位
来自 Kartverket 的国家地址登记册(Matrikkelen – Adresse),每周获取并与各组织的注册地址进行匹配,以便在地图上标注其位置。
代码
组织形式、市镇、行业代码(NACE)和机构部门分类,附带数量统计,与登记册公布的内容一致。
时效性
每个回答都会注明数据来自登记册的哪一期周度版本,助手也可以查询数据的更新程度。

不包含的内容

  • 职务与人员信息:无董事会成员、总经理或所有者信息。
  • 完整的年度财务报表、附注或审计报告。
  • 个体经营企业的联系方式、原用名称和经营活动描述。
  • 批量导出或登记册副本。

使用限制

每日调用次数
每个套餐均包含每个 Publifye 账户的每日工具调用额度。该额度在 UTC 午夜重置。各套餐额度
关键财务数据
每个账户每分钟最多从 Regnskapsregisteret 实时获取 30 次数据。超出后将返回已获取的数据,或提示何时可以重试。
响应大小
默认每次回答约 24 KiB,可在 4 至 48 KiB 范围内调整。更长的结果可通过游标继续获取,游标有效期为 15 分钟。
半径
单独使用半径搜索时最大为 10 km,搭配其他筛选条件时最大为 50 km。
搜索深度
单次搜索最多可分页浏览 10,000 条结果。使用筛选条件缩小范围即可查看其余结果。

每日额度用尽时

在额度重置之前调用将被拒绝,并返回助手可读取并解释的错误信息。形式如下:

{"reason": "quota_exceeded", "service": "brreg-service", "window": "day", "limit": …, "resets_at": "…T00:00:00Z"}

隐私

  • Brreg 专注于组织信息。它不是人员登记册,无法用于查询个人。
  • 个体经营企业与特定个人相关联,因此 Brreg 会隐去原用名称、经营活动描述和联系方式,且不指定名称的搜索绝不会列出此类企业。
  • 不提供仅基于地址的个人查询,亦不支持批量导出。
  • 个人独资企业及其下属单位不会获得地图点位,不会出现在半径搜索中,在点位共享时也不计入统计。
  • 仅在您提出明确要求时才会提取关键财务数据。
  • 我们记录的内容:对于客户账户的每次工具调用,记录账户、客户端 IP 地址、所用工具及结果,但绝不记录您发送的参数。审计记录保存 365 天。
  • 数据移除:当 Brønnøysundregistrene 从开放数据中移除某项记录时,Brreg 会在 24 小时内将其删除。

许可与署名

登记册数据是来自 Brønnøysundregistrene 的开放数据,遵循挪威政府开放数据许可(NLOD 2.0)。每个回答均附有该许可所要求的署名:

Inneholder data under Norsk lisens for offentlige data (NLOD) tilgjengeliggjort av Brønnøysundregistrene.

地图点位与距离来自 Matrikkelen – Adresse,© Kartverket,基于知识共享署名 4.0 国际许可协议(CC BY 4.0)。Publifye 已将地址点位与各组织的注册地址进行匹配;它们不代表企业的实际经营地点。包含点位或距离的回答亦带有此署名。阅读 CC BY 4.0

Brreg 由 Publifye AS 运营,并非官方登记册。凡涉及法律效力的事务,请以 virksomhet.brreg.no 上的官方记录为准。阅读许可条款

支持

有疑问、回答有误或内容缺失?请联系 Publifye 支持团队,并注明您咨询的是 Brreg。联系支持团队