文档

连接 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
  • document_year
  • fields
  • include_subunits
  • live
  • max_bytes
  • orgnr
  • orgnrs
  • snapshot_id

entity_nearby

Finds the organisations registered nearest a map point, closest first, with the distance to each. The point is the address in the register, not where the business actually operates.

  • radius_km
  • city
  • compact
  • cursor
  • employees_max
  • employees_min
  • fields
  • kind
  • lat
  • limit
  • lon
  • max_bytes
  • municipality
  • nace
  • org_form
  • orgnr
  • parent_orgnr
  • postcode
  • public_body
  • sector
  • snapshot_id
  • status
  • vat_registered

entity_distance

Measures how far apart organisations are, and which of several is nearest a given place. This is the straight-line distance between registered addresses, not driving distance and not travel time.

  • from
  • to
  • compact
  • cursor
  • max_bytes
  • snapshot_id

entity_financials

Fetches key figures from the annual accounts, the years a company has actually filed, a comparison with its industry, and the filed document itself, only for the companies you ask about.

  • compact
  • cursor
  • document_year
  • include
  • 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
  • max_bytes

operator_guide

Explains what Brreg can do, how to connect, and ways to use it with your assistant.

搜索指定地点附近

向 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"]

使用模式匹配字段

为 entity_search 提供 match 过滤器，它将仅保留字段与您的模式相匹配的组织——最多可指定四个，每个字段一个，并与您的其他过滤器一并应用。

  • 可对七个字段进行匹配：activity、address、city、email、name、phone 和 website。
  • 模式为 RE2 正则表达式，匹配时不区分大小写，并由您自行设定定位点。单个句点仅测试该字段是否存在。
  • 尽可能使用定位点：^post 可缩小扫描范围并且速度快。未加定位点的模式在首次使用时会读取该字段的每个值（约需十分之一秒），其结果会被保留以供后续调用方使用。
  • 匹配操作在周度版本上运行，因此自上次重新构建以来注册的组织或变更的值，将根据该版本所包含的内容进行匹配。
entity_search match=[{"field":"email","pattern":"^post"}] municipality="4601"

数据与来源

Enhetsregisteret
来自 Brønnøysundregistrene 的主体单位与下属单位数据，每周基于完整登记册重新构建。在两次重构之间，登记册自身的更新源（大约每小时读取一次，夜间频率较低）会刷新周度版本中已有的条目并移除已删除的条目；自上次重构以来新登记的组织可通过其组织编号查询到，但在下次重构前不会出现在搜索结果中。当条目从开放数据中移除后，会在 24 小时内从 Brreg 中消失。
Regnskapsregisteret
提供最新呈交年度财务报表的关键财务数据、机构实际已申报的会计年度，以及所呈交的报表文档本身：即呈交时的完整文档，可追溯约十五年，这也是无法获取关键财务数据的银行与保险机构的唯一查阅途径。文档以带有有效期的私有链接形式提供，且为无文本图层的扫描图像，因此仅供人工打开阅读，而非可供助手提取数据的格式。所有内容仅在您明确要求时才会提取，且数值始终注明所属年份。
Kartverket 地址点位
来自 Kartverket 的国家地址登记册（Matrikkelen – Adresse），每周获取并与各组织的注册地址进行匹配，以便在地图上标注其位置。
matrikkel 单元与建筑物
对于包含地图点位的组织：matrikkel 单元（gnr/bnr，以及当该地址仅包含一个分区时的分区编号）、grunnkrets、堂区和 tettsted，以及当该地址现存建筑物中至少有一处非住宅时的建筑物信息。每周从 Kartverket 的 Matrikkelen – Adresse、Bygningspunkt 和 Adresse Leilighetsnivå 获取。这是注册地址所在的 matrikkel 单元，而非组织名下拥有的财产。
代码
组织形式、市镇、行业代码（NACE）和机构部门分类，附带数量统计，与登记册公布的内容一致。
时效性
每个回答都会注明数据来自登记册的哪一期周度版本。通过机构代码进行的查询还会显示自该版本以来发布的变更，并标注读取时间，助手亦可询问数据的时效性。

不包含的内容

  • 职务与人员信息：无董事会成员、总经理或所有者信息。
  • 作为结构化数据的完整年度财务报表：详细科目、附注及审计报告均不提供——上述内容中仅关键财务数据以数据形式提供。呈交的文档本身可按需通过带有有效期的私有链接获取，但由于它是没有文本图层的扫描图像，因此无法对其中的任何内容进行检索或解析；大于 40 MiB 的文档将不予转发，回复中会改为指明可供获取该文档的开放数据源。
  • 个体经营企业的联系方式、原用名称和经营活动描述。
  • 批量导出或登记册副本。

使用限制

每日调用次数
每个套餐均包含每个 Publifye 账户的每日工具调用额度。该额度在 UTC 午夜重置。各套餐额度
关键财务数据与呈交报表
每个账户每分钟最多可从 Regnskapsregisteret 进行 30 次实时获取，由关键财务数据与呈交历史记录共享。呈交的文件体积达数兆字节，因此额度限制更为严格：每分钟 3 次。超出任一限制时，您将获得此前已获取的数据，或收到一条说明何时重试的提示。
响应大小
默认每次回答约 24 KiB，可在 4 至 48 KiB 范围内调整。更长的结果可通过游标继续获取，游标有效期为 15 分钟。
半径
单独使用半径搜索时最大为 10 km，搭配其他筛选条件时最大为 50 km。
搜索深度
搜索可以一直分页浏览到结果末尾：跟随 cursor 即可不遗漏任何内容。仅在首次调用时用于向前跳页的 offset 快捷方式会限制在 10,000 条停止。

每日额度用尽时

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

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

隐私

  • Brreg 专注于组织信息。它不是人员登记册，无法用于查询个人。
  • 个体经营企业与特定个人相关联，因此 Brreg 会隐去原用名称、经营活动描述和联系方式，且不指定名称的搜索绝不会列出此类企业。
  • 不提供仅基于地址的个人查询，亦不支持批量导出。
  • matrikkel 单元与建筑物遵循相同规则：个人独资企业、其下属单位或注明为 c/o 的地址均不提供任何内容。未经信息所涉主体的同意，matrikkel 中的信息不得用于广告或营销推广（utleveringsforskriften 第 5 条第三款）。
  • 个人独资企业及其下属单位不会获得地图点位，不会出现在半径搜索中，在点位共享时也不计入统计。
  • 仅在您提出明确要求时才会提取关键财务数据。
  • 我们记录的内容：对于客户账户的每次工具调用，记录账户、客户端 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

包含 matrikkel 单元或建筑物的回答会声明相关信息由私营登记簿提供，正如 utleveringsforskriften 第 5 条第十款所要求的那样。

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

支持

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

立即开始