Agent Price API (AgentShare)

Structured product prices and offers from marketplaces for AI agents and automation — search, best offer, and budget queries with freshness metadata. REST + MCP at agentshare.dev.

原始信息汇总

数据集详情总结：Agent Price API (AgentShare)

一、基本信息

项目	内容
API名称	Agent Price API (AgentShare)
类别	商务 (Commerce)
提供者	Anh Nguyen
订阅者数量	1
定价方案	BASIC（免费）、PRO（$9.00/月）、ULTRA（$39.00/月）、MEGA（$99.00/月）
产品网站	https://agentshare.dev
服务条款	https://agentshare.dev/terms

二、核心功能

该API为AI代理、自动化和RAG/LLM工作流提供结构化的JSON格式产品和价格情报，避免返回未经解析的网页内容。主要功能包括：

1. 搜索与报价API

• 产品搜索 (GET /api/v1/search)：提供多个列表和价格比较
• 最佳报价 (GET /api/v1/offers/best)：返回单个最佳报价
• 预算内最佳报价 (GET /api/v1/offers/best-under-budget)：在指定最高价下返回最佳报价
• 元数据发现 (GET /api/v1/meta)：获取能力、认证和功能列表（大多数部署无需密钥）
• 健康检查 (GET /api/v1/health)：检测API可用性
• 覆盖范围 (GET /coverage)：获取实时能力与目录焦点信息

2. 官方AliExpress集成

• 通过AliExpress开放平台（IOP）作为注册联盟应用程序运行
• 使用OAuth 2.0 + 服务端存储的令牌，过期前自动刷新
• 采用HMAC-SHA256请求签名，符合IOP文档规范
• 产品详情路径：GET /api/v1/integrations/aliexpress/affiliate/product-detail?product_ids=...

3. 可靠性信号

• 多数响应包含 freshness_status 和 data_age_seconds 等元数据字段，帮助判断数据的新鲜度和可信度

三、认证方式

• 在所有付费/计量路由上使用 X-API-Key: <your_key> 进行认证
• 密钥和计划获取地址：https://agentshare.dev/pricing

四、其他支持

MCP支持

• 支持通过Streamable HTTP的MCP（模型上下文协议），地址：https://agentshare.dev/mcp
• 适用于Cursor、Claude等MCP客户端

框架集成示例

该API提供了多种AI框架的集成示例代码，包括：

• LangChain：创建ReAct代理和工具
• CrewAI：自定义工具和购物代理
• AutoGPT / 通用代理：通过静态OpenAPI导入
• MCP：面向工具优先的客户端

五、重要说明与限制

1. 价格准确性：数据来自数据源、合作伙伴API和/或允许使用的爬取列表。API返回新鲜度字段，建议将价格视为参考，最终以商家网站结算为准。

2. 联盟链接：当联盟计划启用时，外链可能包含联盟或跟踪参数。

3. 覆盖范围：实时列表和产品焦点通过 GET /coverage 获取。API不声称与Tiki、Shopee、Lazada等本地市场有官方公共商户API连接。

4. 限流：根据密钥和计划，使用滑动窗口限流（每分钟数十到数百次请求）。超出限制返回429状态码。

5. CORS与浏览器使用：主要适用于服务器和代理客户端，生产环境中CORS对浏览器来源受限。

六、技术细节

项目	内容
基础URL（直接）	https://agentshare.dev
认证头	X-API-Key
OpenAPI导入URL	https://agentshare.dev/openapi.json
机器可读索引	https://agentshare.dev/agent.json、https://agentshare.dev/.well-known/discovery.json
MCP地址	https://agentshare.dev/mcp