Itunes Search

@pipeworx/itunes-search

Apple iTunes Search MCP — iTunes Store カタログを検索します：音楽、映画、ポッドキャスト、オーディオブック、電子書籍、ソフトウェア／アプリ。認証は不要です。

Pipeworx の一部です — AI エージェントを1882以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式インテグレーションであり、上流プロバイダーとは提携関係になく、同社から承認や公開を受けていません。

ツール

• search(term, media?, entity?, attribute?, country?, limit?, lang?, explicit?) — 基本検索
• lookup(id?, bundle_id?, isbn?, upc?, amg_artist_id?, amg_album_id?, country?, entity?, limit?) — ID による完全一致検索
• top_movies(country?, limit?) — 興行収入上位の映画（RSS ベース）
• top_podcasts(country?, limit?) — 人気ポッドキャスト
• top_books(country?, limit?, free_or_paid?) — 人気の電子書籍

データソース

• 検索：https://itunes.apple.com/search
• 参照：https://itunes.apple.com/lookup
• チャート：https://rss.applemarketingtools.com/api/v2/<country>/...

検索／参照のレート制限は IP ごとに約20リクエスト／分です。チャートは静的で、キャッシュされます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "itunes-search": {
      "url": "https://gateway.pipeworx.io/itunes-search/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/itunes-search/mcp の tools/list は、上記の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recall、その他ゲートウェイ全体で利用できるツール一式）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールと並んで、共通ツールがおよそ30個表示されます。接続の initialize レスポンスに正確な範囲が示されており、その日の状況を確認するための確かな情報源となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うことで、このパックが扱わない質問にも ask_pipeworx 経由でカタログ全体を対象に回答でき、MCP サーバーを追加する必要がありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールを直接一覧表示できます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ1882以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらから接続しても、ask_pipeworx を使えばすべてのツールを利用できます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/itunes_search_search \
  -H 'Content-Type: application/json' \
  -d '{"term":"Taylor Swift"}'

最初の呼び出しにアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/itunes_search_search を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても動作します。Pipeworx アカウントも、ゲートウェイを経由する必要もありません：

{
  "mcpServers": {
    "itunes-search": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-itunes-search"]
    }
  }
}

または、直接実行して起動を確認できます：

npx -y @pipeworx/mcp-itunes-search

stdin/stdout 経由で MCP をやり取りし、このパック独自のツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。データソースとツールは同じですが、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Itunes Search data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT