apiempresas について
APIEmpresas MCPは、APIEmpresas.esのスペイン企業データをMCP対応アシスタントに提供します。読み取り専用ツールで企業検索、KYB確認、登記公告、公共入札、補助金、制裁リスト照会を行えます。
主な機能
- 01CIFまたは名称による企業検索
- 02KYB確認とVAT番号チェック
- 03BORME履歴とリスクプロファイル
- 04公共契約・入札・補助金の検索
- 05EU・国連・OFAC制裁リストの照会
- 06プランと利用枠の確認
活用シーン
- 01スペイン企業の登記情報を確認
- 02企業と管理者の情報を検証
- 03公告、契約、公共補助金を調査
- 04企業や管理者の制裁リスト該当を確認
MCP 対応
MCPサーバーはAPIEmpresas.esの読み取り専用ツールを対応クライアントに公開します。APIキーが必要で、指定のサンドボックスを除き呼び出しはアカウントの照会枠を消費します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://apiempresas.es/api/mcpclaude mcp add --transport http abasmartinc-apiempresas https://apiempresas.es/api/mcp{"mcpServers":{"abasmartinc-apiempresas":{"type":"http","url":"https://apiempresas.es/api/mcp"}}}Cursor で開く{"servers":{"abasmartinc-apiempresas":{"type":"http","url":"https://apiempresas.es/api/mcp"}}}VS Code で開く{"mcpServers":{"abasmartinc-apiempresas":{"type":"http","url":"https://apiempresas.es/api/mcp"}}}{"mcpServers":{"abasmartinc-apiempresas":{"serverUrl":"https://apiempresas.es/api/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://apiempresas.es/api/mcp認証が必要ツール
8| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| cif | string | はい | CIF/NIF de la empresa española, p. ej. A46103834 (se aceptan espacios y guiones) |
| include_directors | boolean | いいえ | true にすると、取締役と現職を含めます(Pro および Business プラン) |
詳細
APIEmpresas MCP
APIEmpresas.es 公式の MCP サーバーです。Claude、Cursor、VS Code、および MCP 対応のすべてのアシスタントで、スペイン企業のデータを利用できます。
自然な言葉で質問すると(「Mercadona は営業中ですか?管理者は誰ですか?」「この40社のCIFを調べて」「この企業は破産手続きをしたことがありますか?」など)、アシスタントがあなたのキーを使って API を照会します。
ツール
| ツール | 機能 | プラン |
|---|---|---|
get_company | CIF で企業を検索します。商号、状態、設立、県、CNAE、法人形態(ISO 20275)、LEIを取得できます。プランに応じて、所在地、単独株主、グループ親会社、管理者も取得できます | Free(一部データのみ)、Pro |
search_companies | 企業名で検索します | Free |
verify_company | KYB 検証を行います。企業の存在と営業状態、名称および管理者(または単独株主)の一致を確認し、指定があれば VIES で VAT 番号も照合します。法人形態、LEI、親会社、単独株主も取得できます(2回照会) | Pro |
find_cif_by_name | 企業名から CIF を検索します。県を任意指定して候補を絞り込み、1回につき最大100件を処理できます(一致した場合のみ課金) | Pro |
get_borme_history | BORME に掲載された登記情報を取得します | Pro |
get_risk_profile | BORME に基づくリスクプロファイルを取得します | Business |
get_public_contracts | 落札した公共契約を取得します | Business |
get_subsidies | 2022年以降の BDNS 公的補助金・助成金(Kit Digital を含む)を取得します。年別、制度別、募集別の概要と、採択情報を取得できます(1.3.0 以降) | Business |
search_tenders | 公募中の公共入札を、キーワード、CPV、県、種別、金額で検索します。または企業がすでに落札した案件に類似する入札を検索できます(cif) | Business |
check_sanctions | EU、国連、OFAC の制裁リストを照会します。企業とその管理者(cif)、または名称(name)を対象に、一致度も確認できます | Business |
get_usage | プラン、利用可能な照会回数、クレジット残高を取得します(無料。Sandbox では利用できません) | すべて |
すべて読み取り専用です。API と同様、呼び出しごとにプランの照会回数を消費します。
インストール
- 無料アカウントを作成し(クレジットカード不要、照会100回)、apiempresas.es のパネルから API キーをコピーします。
- クライアントにサーバーを追加します(Node.js 18 以上が必要です)。
Claude Desktop
claude_desktop_config.json に追加します。
{
"mcpServers": {
"apiempresas": {
"command": "npx",
"args": ["-y", "apiempresas-mcp"],
"env": { "APIEMPRESAS_API_KEY": "tu_api_key" }
}
}
}
Claude Code
claude mcp add apiempresas --env APIEMPRESAS_API_KEY=tu_api_key -- npx -y apiempresas-mcp
Cursor
~/.cursor/mcp.json(またはプロジェクト内の .cursor/mcp.json)に、Claude Desktop と同じ mcpServers ブロックを追加します。
VS Code
.vscode/mcp.json に追加します。
{
"servers": {
"apiempresas": {
"type": "stdio",
"command": "npx",
"args": ["-y", "apiempresas-mcp"],
"env": { "APIEMPRESAS_API_KEY": "tu_api_key" }
}
}
}
無料でのテスト
APIEMPRESAS_BASE_URL=https://apiempresas.es/api/sandbox/v1 を指定すると、照会回数を消費せずに呼び出せます(テスト用 CIF の A15075062 と B00000000 のみ対応)。
知っておくとよいこと
- 登記上の状態、スコアリング、リスクプロファイルは、APIEmpresas が BORME に基づいて算出します。商業登記所の証明書ではありません。
- 実質的支配者、制裁リスト、PEP、および個人事業主(自営業者)は対象外です。
- 料金:Free は照会100回、Pro は月額19 €(月3,000回)、Business は月額49 €(月10,000回)です。サブスクリプション不要のクレジットパックは9 €から利用できます。VAT は含まれません。詳細は apiempresas.es をご覧ください。
- API の完全なドキュメント:apiempresas.es/documentation。
English
APIEmpresas.es の公式 MCP サーバーです。スペイン企業データを扱う REST API で、CIF(納税者番号)による検索、名称検索、KYB 検証、取締役、BORME(商業登記公報)の登記情報、公共契約、リスクプロファイルに対応しています。apiempresas.es で無料の API キー(リクエスト100回分)を取得し、APIEMPRESAS_API_KEY を設定して npx -y apiempresas-mcp を実行してください。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。