LegalOne Entreprises

LegalOne Entreprises

Français

免费的只读 REST API 和无需密钥的 MCP 服务，提供法国企业公开数据，以及法国法定公告（annonces légales）的辅助工具。

• 企业：身份信息、总部、营业场所、股本、现任负责人（姓名和职务），数据来自 INSEE Sirene 和 INPI RNE。
• BODACC 公告：企业的最新公告（成立、变更、出售业务、破产程序、注销），以及 INPI 列出的契据和账目申报。
• 地址：使用 Base Adresse Nationale 进行自动补全、标准化和反向地理编码。
• 法定公告：企业事项需要发布哪些公告、其法律依据和管制费率、后续步骤，以及一份由用户审核并在 legalone.fr 发布的草稿。

该 MCP 服务在 MCP 注册表中列为 LegalOne Entreprises（注册表中另有一款名为「LegalOne」的产品，与此无关）。

本仓库仅包含公开的客户端材料：Agent 技能、两个单文件 SDK（TypeScript、Python）和 MCP 注册清单。

MCP 服务

URL	https://mcp.legalone.fr/mcp
传输方式	Streamable HTTP
身份验证	无
配额	每个 IP 每分钟 60 次请求，每天 1,000 次请求

工具：search_companies、get_company、get_establishment、list_bodacc_notices、get_bodacc_notice、list_company_documents、search_addresses、get_legal_notice_price、which_legal_notice、get_next_steps、prepare_legal_notice。除 prepare_legal_notice 会在 legalone.fr 保存草稿外，所有工具均为只读。在聊天中不会产生任何付费操作。

Claude（claude.ai 和 Claude Desktop）：前往 Settings > Connectors > Add custom connector，将名称设为 LegalOne Entreprises，URL 设为 https://mcp.legalone.fr/mcp，无需身份验证。在 claude.ai 中添加的连接器也可在 Claude Desktop 中使用。

Claude Code：

claude mcp add --transport http legalone-entreprises https://mcp.legalone.fr/mcp

ChatGPT：前往 Settings > Apps & Connectors > Advanced settings，开启开发者模式，然后使用 URL https://mcp.legalone.fr/mcp 创建连接器，无需身份验证。是否可用取决于你的 ChatGPT 套餐；菜单名称可能会变更。

其他客户端（支持远程服务）：

{
  "mcpServers": {
    "legalone-entreprises": { "url": "https://mcp.legalone.fr/mcp" }
  }
}

仅支持 stdio 的客户端可通过 npx -y mcp-remote https://mcp.legalone.fr/mcp 等桥接工具连接。

REST API

基础 URL	https://api.legalone.fr/v1
密钥	每个 /v1 路由都必须提供：Authorization: Bearer lo_…（或 X-API-Key）。免费：在 https://legalone.fr/developers 创建开发者账户，然后在开发者空间中创建密钥
接口规范	https://api.legalone.fr/v1/openapi.json（无需密钥）
每个密钥的配额	每分钟 60 次、每天 5,000 次、每月 100,000 次请求；企业搜索每分钟 20 次。可在开发者空间申请更高配额

请在服务器端保管密钥；切勿将其放入客户端代码。

# Company profile by SIREN
curl -s https://api.legalone.fr/v1/entreprises/552032534 \
  -H "Authorization: Bearer $LEGALONE_API_KEY"

# Search by start of name, or exact SIREN/SIRET
curl -s --get https://api.legalone.fr/v1/entreprises \
  --data-urlencode "q=exemple" -H "Authorization: Bearer $LEGALONE_API_KEY"

# Latest BODACC notices
curl -s "https://api.legalone.fr/v1/entreprises/552032534/bodacc?limit=5" \
  -H "Authorization: Bearer $LEGALONE_API_KEY"

# Normalise an address
curl -s --get https://api.legalone.fr/v1/adresses/normaliser \
  --data-urlencode "q=8 boulevard du Port 80000 Amiens" \
  -H "Authorization: Bearer $LEGALONE_API_KEY"

每个响应的格式均为 { data, meta, links }；meta 包含 updatedAt、sources、warnings 和 attribution。错误采用 RFC 9457（application/problem+json）：400 参数错误，401 缺少或密钥无效，404 未知或非公开数据（视为「未找到」，不要重试），429 超出配额（等待 Retry-After），503 请稍后重试。完整路由列表见 OpenAPI 接口规范和 SKILL.md。

SDK

每个 SDK 都是一个无依赖的单文件：复制到你的项目中即可。

// sdk/typescript/legalone.ts — native fetch (Node 18+, browsers, Deno, Bun)
import { LegalOne } from "./legalone.ts";

const api = new LegalOne({ apiKey: process.env.LEGALONE_API_KEY! });
const company = await api.getCompany("552032534"); // null if not found
console.log(company?.data.name, company?.meta.attribution);

# sdk/python/legalone.py — standard library only, Python 3.9+
from legalone import LegalOne

api = LegalOne(api_key="lo_...")
company = api.get_company("552032534")  # None if not found
if company:
    print(company["data"]["name"], company["meta"]["attribution"])

方法：getCompany / get_company、getEstablishment、searchCompanies、listBodaccNotices、getBodaccNotice、listCompanyDocuments、health。发生错误时会抛出 LegalOneError（包含状态码、标题、详情、请求 ID，以及 429 错误时的重试延迟）。代码注释和错误消息为法语。

Python 测试（本地 loopback 服务器，无需网络）：cd sdk/python && python3 -m unittest -v。

Agent 技能

SKILL.md 会告知 Agent 何时以及如何使用 API 或 MCP 服务。Claude Code：将其复制到 .claude/skills/legalone/SKILL.md。其他 Agent：向其提供 https://api.legalone.fr/skill.md。

数据来源与许可

来源	许可
INSEE Sirene	Licence Ouverte 2.0
INPI RNE	INPI licence for reuse of the RNE (2024)
DILA BODACC	Licence Ouverte 2.0
Base Adresse Nationale	Licence Ouverte 2.0
Légifrance（法律声明规则）	Licence Ouverte 2.0

每个响应都会在 meta.sources 中列出实际使用的数据来源及其更新日期。

署名（必需）

将 meta.attribution 原样显示在数据旁边。公司数据的署名内容为：

数据：LegalOne — 来源：INSEE Sirene、INPI RNE、DILA BODACC，更新日期：{date}

{date} 是 meta.updatedAt，格式为 DD/MM/YYYY；“LegalOne”应链接到公司页面（data.links.legalone）或 https://legalone.fr。地址路由的署名内容为 Adresses : Base Adresse Nationale (BAN), Licence Ouverte 2.0 — via LegalOne。不得将数据描述为经 INPI 或 INSEE 认证。

限制

• 数据用于预填和补充信息，不是监管身份核验（KYC）来源，也不是法律证明：请通过官方 Kbis 或 RNE 摘录进行核验。
• 个人数据仅限负责人姓名和职务。不提供联系方式、人员搜索、财务报表或受益所有人信息。
• 不提供数据未公开分发的公司，以及在 LegalOne 上反对公开其信息的公司或个人的数据。
• 法律声明规则和步骤仅供参考；遇到特殊情况时，请咨询法律专业人士。

条款、隐私与支持

• 使用条款：https://legalone.fr/developers/conditions
• 隐私：https://legalone.fr/developers/conditions#confidentialite
• 反对（GDPR）或更正请求：https://legalone.fr/developers/opposition
• 支持：[email protected]

许可证

本仓库中的代码和文档遵循 MIT 许可证。API 返回的数据仍受上述来源许可证和 LegalOne 使用条款约束。