TenderScope

tenderscope-lite

AI エージェントが公式の TED 検索 API から公開中の EU 公共入札をリアルタイムで検索できる、小さな MCP サーバーです。

• ツールは 1 つ：search_tenders
• stdio 経由でローカル実行。データベース、アカウント、API キーは不要です
• ウェブページではなく、構造化されたカード（タイトル、発注者、国、予算、締切、リンク）を返します
• 締切がまだ未来の入札のみが対象です

招待書類から予算を読み取るアルメニアの入札（ARMEPS）、ウォッチリスト、締切アラート、ホスト型 API をお探しですか？ それらはホスト型サービスの TenderScope（無料プランあり）で利用できます。このパッケージは、そのオープンソースの軽量版です。

インストール

Node.js 22 以降が必要です。

npx -y github:MarutMarutyan/tenderscope-lite

または、リポジトリをクローンして使用します（リポジトリにはビルド済みの dist/ が含まれています）。

git clone https://github.com/MarutMarutyan/tenderscope-lite.git
node tenderscope-lite/dist/tenderscope-lite.mjs

Claude Desktop に接続する

設定ファイルを開き（Settings、Developer、Edit Config）、次の内容を追加します。

{
  "mcpServers": {
    "tenderscope-lite": {
      "command": "npx",
      "args": ["-y", "github:MarutMarutyan/tenderscope-lite"]
    }
  }
}

Claude Desktop を再起動し、「来月が締切のドイツの公開中 IT 入札を探してください」と尋ねます。

Cursor に接続する

同じブロックを ~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "tenderscope-lite": {
      "command": "npx",
      "args": ["-y", "github:MarutMarutyan/tenderscope-lite"]
    }
  }
}

ツール：search_tenders

引数	型	意味
q	string	キーワード。例：software development。空でもかまいません。
countries	string[]	発注者の国。ISO 3166-1 alpha-2（EU/EEA）。例：["DE","FR"]
cpv	string[]	CPV コードのプレフィックス。IT サービスの場合は ["72"] など
days	integer	過去 N 日間に公開された通知を検索します（1～90、既定値は 30）
limit	integer	返すカードの数（1～20、既定値は 10）

レスポンス：{ "results": [ { id, title, buyer, country, budget, currency, deadline, publishedAt, cpv, url } ] }。結果が空の場合は、検索範囲を広げる方法を示す hint が含まれます。予算は文字列（"125000.00"）、日付は ISO 8601 UTC 形式です。通知に記載がない場合、どちらも null になることがあります。

注意事項

• データは TED Search API v3 から直接取得します（HTML のスクレイピングは行いません）。適切にご利用ください。ツールの呼び出し 1 回につき、リクエストは 1 件です。
• 返すのは通知のメタデータとリンクのみで、文書の本文は返しません。

開発

npm install
npm run build   # bundles into dist/tenderscope-lite.mjs
npm test        # tests with a stubbed fetch, no network

src/vendor/ にある TED 通知パーサーはホスト型サービスと共有されており、リリースのたびにそのリポジトリからコピーされます。修正はこのリポジトリに issue またはプルリクエストとしてお送りください。内容はホスト型サービスにも反映されます。

ライセンス

MIT