Iran Apps

AI エージェント向け

• 概要： イランの大手 Android アプリストアである Cafe Bazaar（cafebazaar.ir）と Myket（myket.ir）向けの非公式 MCP サーバー（モデルコンテキストプロトコル）です。ペルシャ語と英語でクエリできます。
• インストール： uvx iran-apps-mcp または claude mcp add iran-apps -- uvx iran-apps-mcp を実行します。トランスポートは stdio です。uv（Python 3.10 以降）が必要です。
• 認証： 不要です。API キーやアカウントは必要ありません。IRAN_APPS_MCP_PROXY（HTTP プロキシ URL、またはカンマ区切りのリスト）は任意です。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用で、メタデータのみを扱います。ログイン、レビューの投稿、ダウンロードはできないため、ツールを呼び出す前に確認する必要はありません。すべての結果にストアのページ URL が含まれます。
• ツール： 6 個あり、すべて ap_ が先頭に付きます。一般的な手順は、ap_search（パッケージ名を取得）-> ap_compare または ap_app -> ap_similar です。一覧を取得する場合は、最初に ap_categories を呼び出し、スラッグを ap_top に渡します。
• 使用する場面： イランのストアにおける Android アプリのバージョン、評価、インストール数、サイズ、更新日、Myket の更新が Bazaar より遅れているか、カテゴリ内の人気アプリや新着アプリ、アプリの代替アプリについてユーザーから尋ねられた場合。
• 使用しない場面： アプリのインストールやダウンロードをユーザーが希望している場合（ダウンロードリンクや APK リンクはありません）、または Google Play のデータが必要な場合。
• 出力： コンパクトな JSON です。アプリは Android のパッケージ名で識別されます（両ストアで共通）。評価はストアごとに 1～5、installs はおおよその件数、日付は YYYY-MM-DD（グレゴリオ暦）、価格の単位は トマン（0 = 無料）です。
• 機械可読データ： server.json と iran-mcp カタログ。

その理由

Cafe Bazaar と Myket は、イランの Android ユーザーの大半がアプリを入手する場所ですが、どちらも公開 API を提供していません。「このアプリの Myket 版は Bazaar 版より古いか、それぞれのストアでの評価はどうか？」を確認するには、両方のサイトを開いて別々のページを読む必要があります。iran-apps-mcp を使えば、エージェントは一度の呼び出しで回答し、簡潔な要約を返せます。

あなた： Telegram は Myket で Cafe Bazaar と同じくらい最新ですか？

エージェント： 呼び出し ap_search(query="telegram") -> ap_compare(package="org.telegram.messenger")

両方のバージョンを確認し、どちらのストアが新しいかを伝え、評価の差を示します。

できること

• Cafe Bazaar、Myket、または両方で、ペルシャ語または英語の名前を使ってアプリやゲームを検索します
• 1つのアプリの情報を確認します：バージョン、評価と評価数、インストール数、サイズ、更新日、開発者、価格、説明
• 両ストアにある同じパッケージを横並びで比較し、どちらのストアのバージョンが新しいか、評価の差を確認します
• カテゴリごとのトップアプリや新着アプリ（アプリとゲーム）、またはストア全体のトレンドや編集者おすすめのリストを表示します
• 各ストアのカテゴリを一覧表示します（カテゴリのスラッグはストア間で異なります）
• ストアが関連アプリとして表示する類似アプリを検索します
• 設計上、読み取り専用です：ログイン、レビュー、ダウンロードはありません

プロンプトの例：

• 「Cafe BazaarとMyketでSnappを検索して、評価を表示してください。」
• 「両方のストアにあるDigikalaアプリを比較してください：バージョン、評価、インストール数。」
• 「今週のMyketの新着ゲームでおすすめは何ですか？」
• 「Cafe Bazaarのファイナンスカテゴリのトップアプリを教えてください。」
• 「ユーザーがDivarと一緒にインストールしているアプリは何ですか？」
• Cafe BazaarとMyketでBaleアプリを検索して、バージョンと評価を比較してください。
• Myketの新着ゲームでおすすめは何ですか？
• Cafe BazaarでSnappの類似アプリを表示してください。

クイックスタート

uvが必要です。APIキーやアカウントは不要です。

claude mcp add iran-apps -- uvx iran-apps-mcp

{
  "mcpServers": {
    "iran-apps": { "command": "uvx", "args": ["iran-apps-mcp"] }
  }
}

{
  "servers": {
    "iran-apps": { "type": "stdio", "command": "uvx", "args": ["iran-apps-mcp"] }
  }
}

codex mcp add iran-apps -- uvx iran-apps-mcp

[mcp_servers.iran-apps]
command = "uvx"
args = ["iran-apps-mcp"]

{
  "mcpServers": {
    "iran-apps": { "command": "uvx", "args": ["iran-apps-mcp"] }
  }
}

ツール

アプリはAndroidのパッケージ名（例：com.whatsapp）で識別されます。ap_searchで取得できます。

6つのツールすべてにreadOnlyHint: trueが設定されています。

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  iran-apps-mcp  (runs on your machine)
      │
      │  HTTPS
      ├──────▶  api.cafebazaar.ir   JSON API of the Bazaar web app
      └──────▶  myket.ir            page HTML (schema.org JSON-LD, facts table)

iran-apps-mcpはローカルで動作し、間にホスト型サーバーはなく、APIキーも不要です。Cafe Bazaarは、独自のウェブアプリが使用するJSONリクエストを通じて読み取ります。MyketにはJSON APIがないため、ページのHTMLからデータを解析します。リクエストはChromeを偽装するクライアントを通じて送信され、少しランダムな間隔を設けながら同時に最大4件まで処理されます。リクエストが失敗した場合は、最大2回再試行します。読み取りのみを行います。

知っておくと便利な情報

• 価格の単位はトマンです。0 は無料を意味します。どちらのストアも内部ではリヤルで価格を表示しており、サーバーが 10 で割ります。
• installs は概算です。 Bazaar は範囲を返し、Myket は「3,200 万」のようなテキストを返すため、正確な数値ではなく規模を比較してください。
• 評価はストアごと（1～5）で、それぞれのストアから個別に取得します。ストアに評価がない場合は省略されます。
• ページング： Bazaar は 1 ページあたり 24 個のアプリを返し、Myket は 20 個です。Myket の一覧は約 4 ページで終了します。
• カテゴリーはストアごとに異なります。ap_categories を使って、ap_top で有効なスラッグを確認してください。Bazaar のゲームカテゴリー一覧は、調査用の問い合わせで見つかったもので、不完全な可能性があります。
• 名前： Bazaar では英語名が多く、Myket ではペルシャ語名が多く使われています。アプリが片方のストアにない場合（ap_compare では該当箇所が null になります）があります。Google Play のみにあるアプリは、どちらにもありません。
• Myket はページの HTML に依存するため、サイトの再設計で動作しなくなる可能性があります。Bazaar はウェブアプリの JSON API を使用していますが、これは文書化されておらず、変更される可能性があります。
• ネットワーク： テスト時には、どちらのストアもイランからの直接接続と、海外プロキシ経由の接続の両方に応答しました。ネットワークでプロキシが必要な場合は、IRAN_APPS_MCP_PROXY を設定してください。
• 対応していないこと： ダウンロードや APK のリンク、ログイン、レビューやコメント、購入、Google Play のデータには対応していません。開発者の説明やキャッチフレーズは信頼できないテキストとして扱われます。

FAQ

npx @modelcontextprotocol/inspector uvx iran-apps-mcp

設定

ペルシャ語：Cafe Bazaar＆Myket MCP サーバー

claude mcp add iran-apps -- uvx iran-apps-mcp

開発

git clone https://github.com/sepehr071/iran-apps-mcp && cd iran-apps-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests on recorded fixtures
uv run python -m pytest -m live -q  # calls the real stores
uv build

各ツールは、src/iran_apps_mcp/tools.py にある型付きの非同期関数で、エージェントがいつ使用すべきかを説明するdocstringが付いています。IssueやPRを歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新してから、v* タグをプッシュしてください。GitHub ActionsがPyPIに公開します。

関連サーバー

• iran-mcp：イランのサービス向けMCP サーバーを網羅したカタログ
• iran-downloads-mcp：イランのダウンロードサイト向け
• digikala-mcp：Digikalaの商品検索と価格情報向け
• torob-mcp：Torobでの価格比較向け
• divar-mcp：Divarのクラシファイド広告向け

免責事項

非公式であり、Cafe BazaarまたはMyketと提携しておらず、両社の承認も受けていません。読み取り専用で、2つのストアのWebエンドポイントとページを使用します。これらは予告なく変更される場合があります。アプリのデータは情報提供を目的としています。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedInでつながるか、GitHubの@sepehr071をフォローして、イランのWebサイト向けMCP サーバーをご覧ください。すべてiran-mcpに掲載されています。このプロジェクトが役に立った場合は、リポジトリにスターを付けていただけると、ほかの方にも見つけてもらいやすくなります。

ライセンス

MIT