AgentShare

为 AI Agent 提供结构化的市场价格和报价 — 支持 REST API 和 MCP (流式 HTTP)。

本仓库包含用于 Claude Desktop、Cursor 及其他 MCP 客户端的 stdio MCP 服务器，以及极简的 REST 示例。实时 API 和完整集成指南请见上述网站。

面向 AI Agent（机器可读）

• 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 — 可直接粘贴的 mcpServers 代码块，用于 npx mcp-remote（Claude Desktop / Cursor），指向远程流式 HTTP 端点。

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 (流式 HTTP)： 支持 URL + API 密钥标头的客户端可以使用 https://agentshare.dev/mcp/ 并配合 X-API-Key 或 Authorization: Bearer。使用 mcp-config.json 进行 npx mcp-remote。详情：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），以便 Agent 可以判断其可靠性。

方向： 随着集成的成熟，向全球电子商务和主要国际市场扩展。关于当前重点，请参阅 GET /coverage：https://agentshare.dev/coverage

法律

条款与隐私：https://agentshare.dev/terms · https://agentshare.dev/privacy