Polish Companies

🇵🇱 波兰公司 MCP 服务 – Compabase

Compabase MCP 是一个 模型上下文协议 服务，可让 AI 助手（Claude、Cursor、Windsurf、VS Code 及任何兼容 MCP 的客户端）直接访问来自 KRS（国家法院登记处） 和 CEIDG 登记处的 300 多万家波兰公司，以及财务数据、人员、排名和公共登记信息补充数据（SUDOP、BZP、TED、URE、BDO、GPW、KRZ、CRBR、MSiG、欧盟基金）。

用日常语言提问。模型会通过 Streamable HTTP（JSON-RPC 2.0）将提示词映射到结构化工具。

---

快速开始

无需密钥即可连接。Agent 会为你注册，并在电子邮件确认后将 mcpk_… 写入客户端配置。

Cursor / Windsurf / VS Code – .cursor/mcp.json（或等效的 MCP JSON）：

{
  "mcpServers": {
    "compabase": {
      "url": "https://compabase.com/api/mcp"
    }
  }
}

然后让 Agent 为你注册（使用你的电子邮件调用 request_signup）。点击魔法链接后，持续轮询 check_signup，直到 status: ready。如果客户端没有热重载 MCP 配置，请重启客户端。

Claude Desktop – claude_desktop_config.json（获取密钥后）：

{
  "mcpServers": {
    "compabase": {
      "url": "https://compabase.com/api/mcp",
      "headers": {
        "Authorization": "Bearer mcpk_YOUR_KEY_HERE"
      }
    }
  }
}

Claude.ai（Web / Mobile Connectors）：

• 前往 Settings → Connectors → Add Custom Connector
• URL：https://compabase.com/mcp?apiKey=mcpk_YOUR_KEY_HERE
• Authentication：None (Detected)（密钥通过 URL 传递）

也可以在 Integrations → MCP 中创建密钥。MCP 密钥（mcpk_…）与 REST API 密钥（cb_…）相互独立。

字段	值
端点	POST https://compabase.com/api/mcp 或 https://compabase.com/mcp
身份验证	Authorization: Bearer mcpk_…、X-API-Key: mcpk_… 或 ?apiKey=mcpk_…
协议	MCP Streamable HTTP（JSON-RPC 2.0）
MCP 版本	2024-11-05
服务	compabase 1.6.2

---

示例提示词

• 查找华沙收入超过 500 万 PLN 的活跃 IT 公司。
• Allegro 最新的收入和净利润是多少？
• 列出 KRS 为 0000028860 的公司的董事会成员。
• mazowieckie 有多少家活跃公司的主要 PKD 以 62 开头？
• PKD J 类的收入中位数是多少？
• Orlen 是否在 GPW 上市？其股票代码和市盈率（P/E）是多少？

---

可用工具

实时请求始终使用 POST https://compabase.com/api/mcp，其中 method: tools/call，且 params.name 设置为工具名称。工具接受公司标识时，可使用 name、krs 或 nip 来指定公司。货币筛选条件默认使用 PLN。

完整架构：mcp.yaml · 交互式文档。

完整服务包含 54 个工具（根据实时的 tools/list 生成）。

入门（无需密钥）

工具	用途
request_signup	开始设置 Compabase 账户并填写电子邮件
check_signup	轮询 request_signup 会话
list_plans	列出 Compabase 计费套餐和限额

公司数据

工具	用途
search_companies	搜索并筛选波兰 KRS 公司（spółki）
get_company	获取一家公司的注册档案，以及最近一次已申报期间（financials.period_to / financial_period_to）的主要财务数据：收入、利润、成本……
get_financials	获取各财政期间的完整财务报表指标
get_company_people	获取与公司相关的人员
count_companies	统计符合给定筛选条件的 KRS 公司数量
execute_sql	对 Compabase 数据库执行只读 SQL SELECT 查询
get_company_rankings	获取一家公司的收入排名：所在行业（PKD）、地区（省）和全波兰范围
get_financial_stats	获取行业、地区、PKD 分支或全国范围的预计算汇总财务统计数据

注册信息扩展

工具	用途
get_company_public_aid	获取公司的 SUDOP 公共援助／补助金信息
get_company_eu_funds	获取公司的欧洲基金（Fundusze Europejskie）项目
get_company_procurement	获取欧盟委员会 FTS 授标信息
get_company_public_tenders	获取 BZP 公共采购数据
get_company_energy_licenses	获取公司的 URE 能源特许经营许可
get_company_public_contracts	获取波兰中央合同登记册（CRU JSFP，财政部）中的合同，其中该公司是公共部门单位的承包商……
get_company_nfz_contracts	获取公司（作为医疗服务提供者）与波兰国家健康基金（NFZ）之间的合同
get_company_nfz_queues	获取医疗服务提供者的 NFZ（国家健康基金）候诊名单
get_company_trademarks	获取公司拥有或申请的波兰专利局（UPRP）商标
get_company_procurement_disputes	获取涉及该公司的公共采购争议中，国家上诉商会（Krajowa Izba Odwoławcza，KIO）的裁决
get_company_waste_registry	获取 BDO 废弃物和包装登记数据
get_company_stock_market	获取公司的华沙证券交易所上市信息
get_company_eu_tenders	获取达到欧盟门槛的公共采购 TED 信息
get_company_court_gazette	获取一家公司的法院及商业公报（MSiG）公告
get_company_sanctions	获取一家公司的 MSWiA 官方制裁名单信息
get_company_debt_registry	获取 KRZ 破产／重组程序信息
get_company_financial_supervision	KNF 登记册（波兰金融监督局）：金融公司的许可证和登记信息
get_company_website_facts	从公司自有网站读取的信息：营业时间（按星期几）、含地址的分支机构／地点、产品／服务（CPV 部门以及简短的产品／服务……）
get_company_procurement_counterparties	从 BZP、TED 和 CRU 获取公司的公共采购交易对手信息：最常与之中标的采购方、最常向其授予合同的承包商……
get_company_filing_timeliness	从 KRS 登记条目（每份年度报表的申报日期）和财务文件库获取财务报表申报及时性信息：针对每个近期……
get_company_secured_liabilities	从最新财务报表附注（期间结束于 2025 年及以后）获取有担保负债：抵押（hipoteki）、登记质押／金融质押（zastawy）……
get_company_real_estate	从最新财务报表（期间结束于 2025 年及以后）获取公司不动产信息：土地（含永久用益权）、建筑物和房屋、投资性房地产……
get_company_beneficiaries	获取 KRS 公司的 CRBR 受益所有人信息
get_company_articles	从 RAR（Repozytorium Akt Rejestrowych）获取公司章程或组织章程（umowa spółki / statut）全文

账户（跳过 mcp_queries）

工具	用途
get_usage	获取当前计费周期的用量和剩余配额
get_plan	获取用户当前有效计费方案的详细信息
list_watchlist	列出用户关注列表中的公司及其数据（名称、KRS、NIP、收入、城市）
add_to_watchlist	将公司添加到用户的关注列表
remove_from_watchlist	从用户的关注列表中移除公司
list_api_keys	列出用户账户的所有有效 REST API 密钥（cb_…）
create_api_key	创建新的 REST API 密钥（cb_…）
delete_api_key	根据 ID 撤销（停用）REST API 密钥
list_mcp_keys	列出用户账户的所有有效 MCP 密钥（mcpk_…）
create_mcp_key	创建新的 MCP 密钥（mcpk_…）
delete_mcp_key	根据 ID 撤销（停用）MCP 密钥
export_companies	批量导出符合筛选条件的公司数据文件（CSV / XLSX / JSON）
upgrade_plan	创建用于升级方案的 Stripe Checkout 会话
set_webhook_url	配置、查看或移除用于关注列表事件通知的 webhook
get_byok_keys	列出已配置的自带密钥（BYOK）提供商密钥状态
set_byok_key	添加或更新 BYOK 提供商 API 密钥
delete_byok_key	移除已配置的 BYOK 提供商密钥
add_watchlist_batch	一次调用将多家公司添加到关注列表
set_notification_preferences	获取或更新关注列表变更的电子邮件通知偏好设置

---

配额

数据工具（搜索、财务数据、数据增强、SQL）：每次成功的 tools/call 会消耗一个 mcp_queries 单位。

账户工具不消耗 mcp_queries。export_companies 改为消耗 export_companies 配额。

initialize、tools/list 和 ping 不消耗配额。限额会在每个计费周期开始时重置。

方案	MCP 查询次数 / 月	API 请求次数	导出次数
Free	10	100	50
Pro	50	5 000	1 000
Scale	1 000	100 000	20 000
Enterprise	自定义	自定义	自定义

参见 compabase.com/pricing。

---

协议

属性	值
端点	POST https://compabase.com/api/mcp
传输方式	Streamable HTTP
协议版本	2024-11-05
功能	tools
服务端名称	compabase
服务端版本	1.6.2

方法	说明
initialize	握手
tools/list	工具和架构
tools/call	执行工具
ping	保持连接
notifications/initialized	客户端就绪

---

相关资源

• Compabase REST API – OpenAPI 3.1（v1.yaml）
• 交互式 API 文档
• 交互式 MCP 文档
• compabase.com

---

许可证

MIT

Gemini CLI

gemini extensions install https://github.com/ContentWriterco/Compabase-MCP

首次使用时，Gemini CLI 会打开 Compabase 登录页面（OAuth）。如果没有自动打开，请运行 /mcp auth compabase。

Claude Code 插件

此仓库也是一个 Claude Code 插件（MCP 服务 + 技能）：

/plugin marketplace add ContentWriterco/Compabase-MCP
/plugin install compabase@compabase-plugins

设置指南

Claude、ChatGPT、Gemini、Grok、Le Chat、Perplexity、Cursor、VS Code 和 Claude Code 的分步设置指南：https://compabase.com/docs/mcp/connect/