AgentShare

AIエージェント向けの構造化されたマーケットプレイス価格およびオファー — REST APIおよびMCP (Streamable HTTP)。

このリポジトリには、Claude Desktop、Cursor、その他のMCPクライアントで使用されるstdio MCPサーバーと、最小限のRESTの例が含まれています。ライブAPIと完全な統合ガイドは上記のサイトにあります。

AIエージェント向け（機械可読）

• AGENTS.md — ミッション、ツール名、認証、レスポンスエンベロープ、コピー＆ペースト用MCP JSON、OpenAPIへのリンク。

• llms.txt — 同じ要点をまとめた、短くクロールしやすい単一ファイル（LLM / GEOワークフロー用）。

• openapi.json — このMCPで使用されるRESTインターフェース（/api/v1/search、/offers/*、/meta）のOpenAPI 3.0仕様。完全な本番仕様（すべてのルート）は常に https://agentshare.dev/openapi.json にあります（信頼できる唯一の情報源であり、ドキュメントリポジトリの重複はありません）。

• mcp-config.json — リモートのStreamable HTTPエンドポイントを指す、npx mcp-remote（Claude Desktop / Cursor）用の貼り付け可能な mcpServers ブロック。

Related MCP server: Godalo

APIキーの取得

このMCPサーバーまたはREST APIを使用するには、APIキーが必要です。https://agentshare.dev/pricing にアクセスして、無料枠のキーを取得してください（執筆時点で公開無料プランは月間100リクエスト — 常にサイトで確認してください）。

人間向け：クイックインストール (pip)

git clone https://github.com/anhmtk/agentshare-mcp.git
cd agentshare-mcp
pip install -r integrations/mcp_server/requirements.txt
export API_KEY=your_api_key   # Windows: $env:API_KEY="..."
# optional: export BASE_URL=https://agentshare.dev
python integrations/mcp_server/server.py

キーの取得: https://agentshare.dev/pricing

クイックインストール — Claude Desktop (claude_desktop_config.json)

ローカルstdioサーバー（Python）を使用します。パスを、このリポジトリのクローン内にある server.py への絶対パスに置き換えてください。

{
  "mcpServers": {
    "agentshare": {
      "command": "python",
      "args": ["/ABSOLUTE/PATH/TO/agentshare-mcp/integrations/mcp_server/server.py"],
      "env": {
        "API_KEY": "your-api-key-here",
        "BASE_URL": "https://agentshare.dev"
      }
    }
  }
}

• キーの取得: https://agentshare.dev/pricing

• Windowsでは、args 内でスラッシュを使用することをお勧めします。例: D:/code/agentshare-mcp/integrations/mcp_server/server.py。

リモートMCP (Streamable HTTP): URL + APIキーヘッダーをサポートするクライアントは、X-API-Key または Authorization: Bearer を使用して https://agentshare.dev/mcp/ を利用できます。npx mcp-remote には mcp-config.json を使用してください。詳細: MCPクイックスタート（MCPセクション）。

高度な設定 — mcp-remote (Node / npx) を介したHTTP: mcp-remote を使用してHTTPSからstdioへブリッジする場合、--header でキーを渡してください（Cursor MCPセットアップのトラブルシューティングを参照）。このリポジトリは npx agentshare-mcp パッケージを公開していません。

stdio MCPのローカルでのクローンと実行

リポジトリのルートから:

pip install -r integrations/mcp_server/requirements.txt
export API_KEY=your_api_key
# optional: export BASE_URL=http://localhost:8000
python integrations/mcp_server/server.py

python integrations/mcp_server/run.py と同じです。ツールと環境については integrations/mcp_server/README.md を参照してください。

コード例 (REST)

examples/ フォルダーには、公開JSON API（GET /api/v1/search など）を呼び出す小さなスクリプトがあります。MCPを接続する前にキーをテストするのに便利です。

MCPディレクトリとリスト

本番環境のディスカバリー（認証なし） — カタログに登録する際はこれらのURLを使用してください:

サードパーティのインデックス（AgentShare またはあなたのリストURLで検索してください）:

• Smithery — MCPサーバーレジストリ

• Glama — MCP / AIゲートウェイディレクトリ

ライセンス

MIT — LICENSE を参照してください。

GitHub — CIとリポジトリトラフィック

• CI: プッシュ/PR時にMCPパッケージのインポートを検証します — Actions → CI。

• トラフィック: GitHubは集計された閲覧数/クローン数のみを表示します（メンテナー向けの Insights → Traffic）。毎週の GitHubトラフィックのスナップショットは、API結果を実行の Summary に書き込みます（Insightsと同じ考え方です）。

スコープ（誠実かつ将来を見据えて）

AgentShareは、接続されたマーケットプレイスおよびアフィリエイトソースから製品およびオファーデータを集約します。カバレッジと鮮度はソースによって異なります。APIは鮮度メタデータ（例: crawled_at、data_age_seconds、freshness_status）を返すため、エージェントは信頼性を判断できます。

方向性: 統合が成熟するにつれて、グローバルなEコマースおよび主要な国際的マーケットプレイスへと拡大します。現在の焦点については、GET /coverage を参照してください: https://agentshare.dev/coverage

法的情報

利用規約とプライバシー: https://agentshare.dev/terms · https://agentshare.dev/privacy