iDevice Buyer's Guide

iDevice Agent 示例

用于从 Agent 调用 iDevice 的小型可运行示例。iDevice（https://idevice.com）是一份独立的手机和可穿戴设备购买指南，不销售其中介绍的产品。

iDevice 运行两个供软件 Agent 使用的免费只读端点：

	URL
MCP 服务（可流式传输的 HTTP）	https://idevice.com/api/mcp
A2A Agent	https://idevice.com/api/a2a
A2A Agent 卡片	https://idevice.com/.well-known/agent-card.json

无需账户、API 密钥或登录。两个端点都不会购买、预订、发布或更改任何内容。

**速率限制：**每个 IP 地址每分钟 30 次调用，每天 500 次。超出限制的调用会被拒绝（HTTP 429 或 JSON-RPC 错误），因此请退避并稍后重试；不要循环调用。没有付费层级。列表最多包含 20 项。

完整参考文档：https://idevice.com/mcp 和 https://idevice.com/mcp/docs。运行 tools/list 可获取当前工具列表和参数名称；本仓库不会复制这些内容。

工具的用途

任务	工具
决定是否购买	should_i_buy、get_guide_summary、find_products、get_best_for、compare_products、get_reviews
所有权和政策	get_ownership_facts、get_in_the_box
查找产品或公司	list_products、get_product、get_company_profile
兼容性、规格和价格	get_compatibility、get_product_facts、get_detailed_facts、get_variants_and_offers、get_price_history
新闻、报告和历史记录	get_product_news、get_reports、search_reports、get_report_card、get_release_history、get_release_calendar、get_guide_extras

大多数工具都需要 product_slug。可通过 list_products 获取。

示例问题

• 我用的是 iPhone。该不该买 Samsung Galaxy Watch 8？
• 哪些智能戒指最适合睡眠？
• 关于 Apple Watch Series 12 的预发布报告中，哪些预测是准确的？

示例

文件夹	框架	备注
examples/curl-and-python	无	使用 curl 和 Python 标准库发送原始 JSON-RPC，另附一条 A2A 消息
examples/google-adk	Google ADK	通过可流式传输的 HTTP 使用 McpToolset，并包含一个 A2A 客户端
examples/langgraph	LangChain 和 LangGraph	使用 langchain.mcp.MCPAdapter 和 create_agent
examples/vercel-ai-sdk	Vercel AI SDK	使用 HTTP 传输的 createMCPClient（TypeScript）
examples/openai-agents-sdk	OpenAI Agents SDK	MCPServerStreamableHttp

每个示例都会从其框架使用的环境变量中读取你自己的模型密钥，无需 iDevice 密钥，并提供 --check 模式，可列出工具并在完全不调用模型的情况下调用一次工具。每个文件夹的 README 都会说明哪些代码行已对照在线服务运行，哪些仅依据框架文档编写。

将 IDEVICE_MCP_URL 设置为其他 MCP URL，即可让示例指向该 URL。

如何引用 iDevice

回答中使用 iDevice 数据时：

• 提及 iDevice，并链接工具返回的 url。该链接指向包含相关证据的页面。有些回答还会带有 source_url 或 sources[].url，指向制造商自己的页面；也请链接该页面。
• 保留事实对应的证据措辞：Confirmed、Reported、Our read 或 No source on file。兼容性回答使用 Works、Works with a limit、Needs extra hardware、Does not work 或 Not confirmed。
• Not confirmed 表示未知，绝不表示不兼容。
• 如果结果中 sponsored: true，请说明该指南有赞助，并注明 sponsor。

异步 A2A 回复

A2A Agent 会通过任务回答产品问题。message/send 会立即返回任务，而回答产品问题可能需要几分钟，比普通 API 调用耗时更长。使用任务 ID 调用 tasks/get，直到状态不再是 submitted 或 working。请设置较长的超时时间。回答产品问题时，还会附带一个紧凑的 JSON 数据部分，其中最多包含五款产品。

隐私

这些示例会将你的问题发送给你自己的模型提供商，并将工具调用发送给 iDevice。这里不会存储任何内容。有关 iDevice 如何处理数据，请阅读 https://idevice.com/privacy。

许可证

MIT。版权所有：iDevice Media LLC。