公共租赁住房开放数据——芬兰贸易登记MCP服务器
一个MCP服务器，为人工智能助手提供结构化访问芬兰贸易登记簿的权限。它包含了来自芬兰专利和注册局（PRH）的三个开放数据API，涵盖了在芬兰注册的所有公司的公司信息、贸易注册文件和数字财务报表。可用于公司研究、尽职调查、市场分析和跟踪芬兰各行业和城市的业务形成。
工具
| 工具 | 说明 |
|---|---|
search_companies | 按名称、城市、行业、公司形式、注册日期或邮政编码搜索公司 |
get_company_detail | 通过企业ID（Y-tunnus）获取公司的完整简介 |
get_registered_notifications | 查阅贸易登记文件——董事会变更、合并、修订、新注册 |
get_financial_statement | 使用解析的损益表和资产负债表指标检索数字财务报表（iXBRL） |
count_companies_by_industry | 在不下载所有数据的情况下，统计给定行业和地点的公司 |
get_recent_registrations | 查找在特定日期范围内注册的公司 |
运作原理
- 搜索 --按名称、地点或行业查找公司
search_companies，或者用它们来计数count_companies_by_industry. - 检查 --使用以下工具获取特定公司的完整简介
get_company_detail其商业ID（例如。0112038-9诺基亚）。 - 跟踪更改 --查看公司已使用以下方式向商业登记簿提交了哪些文件
get_registered_notifications--董事会变更、合并、名称变更、财务报表备案。 - 阅读财务信息 --呼叫
get_financial_statement首先没有日期来列出可用时段，然后有一个特定的日期来获取以欧元为单位的解析指标。
快速开始
git clone https://github.com/SimonBerg255/prh-opendata-mcp.git
cd prh-opendata-mcp
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
uvicorn server:app --host 0.0.0.0 --port 8000API详细信息
- 数据源: 公屋公开数据 --芬兰专利和注册局
- 协议：HTTPS上的REST，JSON响应（返回XML的XBRL财务端点除外）
- 认证：无--所有API都是完全公开的
- 速率限制：所有用户每分钟共享300个请求
- 分页：从1开始的页码；YTJ每页最多返回100，KREK每页最多返回50
- 许可证：立方厘米乘以4.0
- 覆盖：除私人贸易商（toimini）、市政当局和福利服务县外，所有注册的芬兰公司
参考
公司表格代码 （用于 company_form 参数）：
| 代码 | 类型 |
|---|---|
| OY | 有限公司 |
| OYJ | 公共有限公司 |
| KY | 有限合伙 |
| AY | 普通合伙 |
| 好 | 合作 |
| 基金会 | |
| SL | 外商分行 |
行业搜索：The main_business_line 参数接受TOL 2008代码（例如。 62010 用于计算机编程）或自由文本（例如。 software, construction, restaurant).建议默认使用文本搜索。
业务ID格式：芬兰Y-tunnus遵循这一模式 NNNNNNN-N （例如。 0112038-9).始终包含连字符。
通知类型 （用于 notification_type 参数）： U （启动）， M （修订）， H （应用）， T （通知）， TA （财务报表）， FUU （合并）， DIF （Demerger）， JH （向债权人发出公开传票）。
常用输入代码 （用于 entry_code 参数）： HAL （董事会）， NIMO （公司名称变更）， JOH （管理）， TOIM （业务范围）， TASE （资产负债表）。
财务报表：仅适用于以iXBRL格式进行数字归档的公司，每年约有8000家公司。呼叫 get_financial_statement 没有日期可以先查看可用性。
验证
python3 test_tools.py针对实时PRH API运行9个集成测试。检查每个工具是否返回真实数据，每个响应保持在20KB以下，并在20秒内完成。成功后退出0。
许可证
麻省理工学院