iDevice Buyer's Guide

iDevice エージェントの例

エージェントから iDevice を呼び出すための、小規模で実行可能な例です。iDevice（https://idevice.com）は、スマートフォンとウェアラブルの独立系購入ガイドです。掲載対象の製品を販売しているわけではありません。

iDevice は、ソフトウェアエージェント向けに、無料で読み取り専用のエンドポイントを2つ提供しています。

	URL
MCP サーバー（ストリーミング可能な HTTP）	https://idevice.com/api/mcp
A2A エージェント	https://idevice.com/api/a2a
A2A エージェントカード	https://idevice.com/.well-known/agent-card.json

アカウント、API キー、サインインは不要です。どちらのエンドポイントも、購入、予約、投稿、変更を行いません。

レート制限： IP アドレスごとに、1分あたり30回、1日あたり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	create_agent を使った langchain.mcp.MCPAdapter
examples/vercel-ai-sdk	Vercel AI SDK	HTTP トランスポートを使った createMCPClient（TypeScript）
examples/openai-agents-sdk	OpenAI Agents SDK	MCPServerStreamableHttp

各例は、フレームワークが使用する環境変数から自身のモデルキーを読み込みます。iDevice のキーは不要です。また、モデルを使わずにツール一覧を取得し、ツールを1回呼び出す --check モードがあります。各フォルダーの README には、ライブサーバーに対して実行した行と、フレームワークのドキュメントのみを参考に記述した行が示されています。

別の MCP URL を使って例を実行するには、IDEVICE_MCP_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 エージェントは、タスクを使って製品に関する質問に回答します。message/send はタスクを即座に返します。製品に関する質問への回答には、通常の API 呼び出しよりも長い数分かかる場合があります。タスク ID を使って、状態が submitted または working でなくなるまで tasks/get を呼び出してください。長いタイムアウトを設定してください。製品に関する質問への回答には、最大 5 製品分の簡潔な JSON データパートも含まれます。

プライバシー

これらの例では、質問はお使いのモデルプロバイダーに送信され、ツール呼び出しは iDevice に送信されます。ここでデータが保存されることはありません。iDevice のデータの取り扱いについては、https://idevice.com/privacy をご覧ください。

ライセンス

MIT。Copyright iDevice Media LLC.