Goofish (Xianyu) Marketplace

Goofish MCP Server

Claude、ChatGPT、Cursor、VS Code、あらゆる MCP クライアント、または独自のコードから、中国最大の中古品マーケットプレイスである Goofish（Xianyu、闲鱼）を検索できます。

クイックスタート · エージェントのセットアップ · ツール · クライアントのセットアップ · コードから利用 · 料金 · よくある質問 · 中文说明

Goofish MCP は、Xianyu（闲鱼）や Idlefish としても知られるマーケットプレイス Goofish に AI アシスタントを接続します。英語または中国語で質問すると、アシスタントが出品を検索し、中古価格を比較し、商品の詳細をすべて読み込み、販売者の履歴やレビューを確認し、購入者からの質問を読み、写真に一致する出品を見つけます。結果は構造化された行として返され、並べ替え、絞り込み、翻訳、要約ができます。

AI エージェントでセットアップする

このリポジトリの URL を Claude Code、Codex、Cursor、または別のエージェントに貼り付け、Goofish のセットアップを依頼してください。以下の手順に沿って、エージェントがセットアップを進められます。

このサーバーをインストールする AI エージェント向け：

1. これはホスト型のリモート MCP サーバー（ストリーミング可能な HTTP）です。ダウンロードやビルドは不要です。無料の Apify アカウントと、ユーザーのブラウザーでの Apify サインイン（OAuth）が必要です。サインインに失敗しない限り、API トークンを求めないでください。
2. サーバー名は goofish、サーバー URL：

   https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,get-dataset-list,zen-studio/goofish-xianyu-search-scraper,zen-studio/goofish-xianyu-item-detail-scraper,zen-studio/goofish-xianyu-seller-scraper,zen-studio/goofish-xianyu-visual-search-scraper,zen-studio/goofish-xianyu-item-comments-scraper
   

3. クライアント固有のコマンドで追加します：
   • Claude Code：claude plugin marketplace add zen-studio-labs/goofish-mcp、続けて claude plugin install goofish@goofish-mcp を実行します（サーバーと Goofish スキルが追加されます）。
   • Codex：codex mcp add goofish --url "<server URL>"、続けて codex mcp login goofish を実行します。
   • VS Code：code --add-mcp '{"name":"goofish","type":"http","url":"<server URL>"}' を実行します。
   • Cursor やその他のクライアント：クライアントの MCP 設定ファイルに {"mcpServers": {"goofish": {"url": "<server URL>"}}} を追加します（Cursor の場合：~/.cursor/mcp.json）。
4. サインインを完了するようユーザーに依頼します。Claude Code では /mcp を実行し、goofish を選択して Authenticate を選びます。他のクライアントでは Apify のサインインページが自動的に開きます。ツールが表示されるまでに、クライアントの再起動が必要な場合があります。
5. たとえば keyword: "iPhone 15 Pro", maxItems: 5 のように、小規模な検索で動作を確認します。返される出品はすべてユーザーの Apify アカウントに課金されるため、テストの実行規模は小さくしてください。
6. 実際に検索する前に、Goofish スキルを読んでください。長時間の実行の仕組みと、良い結果が得られる入力について説明しています。

Goofish MCP を選ぶ理由

• Goofish アカウントは不要です。 ログインも、Cookie も、中国の電話番号も必要ありません。ご自身の Goofish アカウントが使われることはありません。
• インストールは不要です。 ホスト型のリモート MCP サーバーです。URL を追加して Apify にサインインするだけです。デスクトップアプリだけでなく、claude.ai や ChatGPT でも動作します。
• 1 つのサーバーで 5 つのツールを利用できます。 出品の検索、商品詳細、販売者とレビュー、画像検索、コメントと購入者 Q&A（问大家）。
• 豊富な構造化データ。 出品ごとに 150 以上のフィールドがあります：価格、状態、場所、閲覧数と欲しい数、配送、販売者の信用、販売数、返信率。
• アシスタント向けに設計されています。 同梱のスキルが、アシスタントに効果的な入力を教えます。長いリクエストも、状況を確認しながら実行され続けます。
• 結果に応じた従量課金です。 ご自身の Apify アカウントに課金されます。Apify の無料プランでお試しいただけます。

ツール

すべてのツールは読み取り専用です。商品を購入したり、販売者にメッセージを送ったり、出品を投稿したりすることはありません。

クイックスタート

1. アカウントをお持ちでない場合は、Apify アカウントを無料で作成してください。
2. サーバーをアシスタントに追加します。 上のボタンをクリックするか、以下のクライアント向け手順に従ってください。
3. アシスタントに求められたら Apify にサインインし、 「Goofish で、個人販売者が出品している中古の Sony A7 III のカメラ本体を ¥5,000〜¥8,000 で探し、良さそうな候補を5つ表にまとめてください。」 のように質問してください。

Apify のサインインページについて。 Apify では、アシスタントが「動的に登録され、Apify による検証を受けていません」と表示され、API への完全なアクセスを求められる場合があると説明しています。この方法でサインインするすべてのアシスタントに、この通知が表示されます。アシスタントがあなたのアカウントで実行を開始できるようにするためのものです。アクセス権は、いつでも Apify Console の連携ページで削除できます。

リモート MCP サーバーに対応するクライアント向けのサーバー URL：

https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,get-dataset-list,zen-studio/goofish-xianyu-search-scraper,zen-studio/goofish-xianyu-item-detail-scraper,zen-studio/goofish-xianyu-seller-scraper,zen-studio/goofish-xianyu-visual-search-scraper,zen-studio/goofish-xianyu-item-comments-scraper

クライアントの設定

/plugin marketplace add zen-studio-labs/goofish-mcp
/plugin install goofish@goofish-mcp

claude mcp add --transport http goofish "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,get-dataset-list,zen-studio/goofish-xianyu-search-scraper,zen-studio/goofish-xianyu-item-detail-scraper,zen-studio/goofish-xianyu-seller-scraper,zen-studio/goofish-xianyu-visual-search-scraper,zen-studio/goofish-xianyu-item-comments-scraper"

codex mcp add goofish --url "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,get-dataset-list,zen-studio/goofish-xianyu-search-scraper,zen-studio/goofish-xianyu-item-detail-scraper,zen-studio/goofish-xianyu-seller-scraper,zen-studio/goofish-xianyu-visual-search-scraper,zen-studio/goofish-xianyu-item-comments-scraper"
codex mcp login goofish

{
  "mcpServers": {
    "goofish": {
      "url": "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,get-dataset-list,zen-studio/goofish-xianyu-search-scraper,zen-studio/goofish-xianyu-item-detail-scraper,zen-studio/goofish-xianyu-seller-scraper,zen-studio/goofish-xianyu-visual-search-scraper,zen-studio/goofish-xianyu-item-comments-scraper"
    }
  }
}

各ツールは REST API を備えた Apify Actor でもあるため、アシスタントを介さずに、ご自身のコード、パイプライン、自動化から呼び出せます。Apify Console の integrations ページから API トークンをコピーしてください。入力フィールドはアシスタントが使用するものと同じです。各 Store ページの API タブには、すぐに使えるコードと入力の詳細が記載されています。

pip install apify-client

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("zen-studio/goofish-xianyu-search-scraper").call(
    run_input={"keyword": "iPhone 15 Pro", "maxItems": 20, "sortBy": "priceAsc"}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["price"], item["title"], item["url"])

npm install apify-client

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('zen-studio/goofish-xianyu-search-scraper').call({
    keyword: 'iPhone 15 Pro',
    maxItems: 20,
    sortBy: 'priceAsc',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/acts/zen-studio~goofish-xianyu-search-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "iPhone 15 Pro", "maxItems": 20}'

ほかのツールを使うには、Actor ID を zen-studio/goofish-xianyu-item-detail-scraper、zen-studio/goofish-xianyu-seller-scraper、zen-studio/goofish-xianyu-visual-search-scraper、または zen-studio/goofish-xianyu-item-comments-scraper に置き換えてください。

プロンプトの例

• 上海で、個人出品者のみを対象に、¥800 から ¥1,500 の中古 Nintendo Switch OLED の出品を 30 件、価格の安い順に探してください。
• Xianyu で 乐高 75313 を検索し、最も安い 5 件を状態と出品者の評価で比較してください。
• 今週、Xianyu で中古 iPhone 15 Pro 256GB は通常いくらで出品されていますか？
• この出品の詳細をすべて取得してください：https://www.goofish.com/item?id=1045244773159
• この出品者を調べ、直近 50 件のレビューを要約してください：https://www.goofish.com/personal?userId=2215160932230
• この写真に似た Goofish の出品を探してください：https://example.com/my-jacket.jpg
• この出品について、購入者は何を質問し、出品者はどう回答しましたか？ https://www.goofish.com/item?id=947872178004

ヒント：検索語は、出品者がタイトルに使う表記で入力してください。中国ブランドやカテゴリーには中国語（小米、乐高、手机）を使用します。iPhone 15 Pro のような海外名称は、そのまま使えます。

ユースケース

• 中古価格の調査。 購入や販売の前に、モデル、状態、都市別の一般的な出品価格を調べます。
• 転売と越境購入（代行購入）。 割安な出品を見つけ、購入を決める前に出品者を確認します。
• ブランド保護。 キーワードまたは写真を使って、類似品も含め、自社製品の出品を見つけます。
• 市場調査。 カテゴリーや複数のモデルにわたる閲覧数や購入希望から、需要を把握します。
• 出品者の確認。 信用度、販売数、返信率、最近のレビューをまとめて確認できます。

出力例

検索結果の 1 行を抜粋しています。アシスタントはこのような行を読み取り、わかりやすい言葉で回答します。

{
  "id": "1000000000001",
  "title": "索尼 A7M3 单机身 快门1.2万 几乎全新 带原装电池",
  "price": 6280,
  "currency": "CNY",
  "city": "上海",
  "condition": { "label": "几乎全新" },
  "postedAt": "2026-10-28T19:42:11+08:00",
  "freeShipping": true,
  "stats": { "views": 412, "wants": 23 },
  "seller": {
    "name": "摄影器材闲置",
    "creditLabel": "极好",
    "zhimaVerified": true,
    "stats": { "totalSold": 37, "goodReviewRate": "99%" }
  },
  "url": "https://www.goofish.com/item?id=1000000000001"
}

各ツールの Store ページに、すべてのフィールドが記載されています。

リクエストの処理時間について

各ツールの呼び出しは約 45 秒以内に返されます。それより大きなリクエストは、Apify 上で処理が継続され、アシスタントが結果の準備ができるまで確認してから、ページごとに読み取ります。「実行中」の更新が何度か表示される場合がありますが、これは想定どおりです。Goofish skillでは、この処理の流れと各ツール用の入力例を説明しています。Claude Code では、プラグインを使うと利用できます。

料金

結果ごとに料金が発生し、Apify アカウントに請求されます。このリポジトリのサブスクリプションはありません。ボリューム割引を含む最新の料金は、各ツールの料金ページをご確認ください。

• 出品検索
• 商品詳細
• 販売者プロフィール
• 画像検索
• コメントとQ&A

アシスタントは、maxItems などの結果数上限を設定して費用を管理します。まず少ない数を指定し、その後必要に応じて増やしてください。

Apify の無料プラン： 各ツールには実行回数の上限があり、1 回の実行で取得できる結果数にも上限があります（検索で取得できる出品は最大 30 件です）。実行が上限に達すると、アシスタントがお知らせします。有料の Apify プランでは、これらの上限がなくなります。

トラブルシューティング

• /mcp にサーバーが認証されていない、またはツールを取得できなかったと表示されます。 サーバーを選択し、認証を選んでください。他のクライアントでは、接続またはサインインボタンが表示されます。
• 検索結果が何も表示されません。 中国ブランド名には中国語を使用し（xiaomi ではなく 小米）、価格帯を広げるか、フィルターを解除してください。
• 検索結果が 30 件で止まります。 これは Apify の無料プランの上限です。有料プランでは上限がなくなります。
• アシスタントに、実行がまだ進行中だと言われます。 大きなリクエストでは通常の動作です。同じ実行の状況を引き続き確認するよう指示してください。同じ質問で新たに検索すると、再度請求されます。
• クライアントでサインインを完了できません。 代わりに Apify トークンのヘッダーを使用してください。詳しくはその他のクライアントをご覧ください。

FAQ

Goofish とは何ですか？ Goofish（goofish.com）は、Alibaba の中古品マーケットプレイスである Xianyu（闲鱼）のウェブ上での名称で、Idlefish としても知られています。中古のスマートフォン、カメラ、ゲーム機、コレクターズアイテム、ファッション用品など、さまざまな商品が売買されています。

Goofish のアカウントや中国の電話番号は必要ですか？ いいえ。必要なのは Apify アカウントだけで、作成には 1 分ほどかかります。

中国以外でも使えますか？ はい。どの国からでも使用できます。出品情報のほとんどは中国語で、価格は CNY で表示されます。タイトルの翻訳や価格の換算をアシスタントに依頼してください。

どの AI アシスタントが使えますか？ Claude（claude.ai、Claude Desktop、Claude Code）、ChatGPT、Codex、Cursor、GitHub Copilot を搭載した VS Code など、リモート MCP サーバーに対応するあらゆるクライアントで使用できます。

Goofish API はありますか？ はい。すべてのツールは REST API 経由、または Apify の Python クライアントや JavaScript クライアントから呼び出せます。詳しくはコードから使用するをご覧ください。

無料で使えますか？ Apify の無料プランでは、各ツールの実行回数に上限があります。上限に達した後は結果ごとに料金が発生します。詳しくは料金をご覧ください。

価格の推移を追跡できますか？ はい。アシスタントに検索を繰り返して比較するよう依頼するか、Apify で検索をスケジュールして実行結果を比較してください。

これは Goofish の公式製品ですか？ いいえ。Goofish MCP は Zen Studio による独立した製品であり、Goofish、Xianyu、Alibaba とは提携していません。

プライバシー

リクエストは Apify のホスト型 MCP サーバーに送信され、Apify アカウント上で実行されます。Apify のプライバシーポリシーが適用されます。このリポジトリには設定と手順のみが含まれており、情報を収集することはありません。

中国語の説明

闲鱼（Goofish / Xianyu）のデータを、AI アシスタントで直接利用できます。 Claude、Claude Code、ChatGPT、Codex、Cursor、VS Code など、リモート MCP サーバーに対応するすべてのクライアントで利用できます。

闲鱼のアカウント、ログイン、Cookie、インストールは不要です。 Apify アカウントに一度ログインするだけで、結果に応じて課金されます。

できること：

• 商品検索：キーワードで闲鱼の商品を検索し、価格、状態、地域、画像、販売者のデータを取得できます。価格、地域、掲載日時、個人の不用品、送料無料、新品、验货宝などで絞り込めます。
• 商品詳細：各商品について、詳細な説明、すべての画像、状態、閲覧数と欲しい数、販売者情報など、150 項目以上のフィールドを取得できます。
• 販売者情報：販売者のプロフィール、信用情報、商品一覧（販売済みを含む）、取引評価を取得できます。
• 画像検索：画像をアップロードするか、画像リンクを指定して、外観が似ている闲鱼の商品を見つけられます。
• コメントと「問大家」：商品に対する公開コメント、販売者の返信、「問大家」を取得できます。

すべてのツールは読み取り専用です。注文、販売者への連絡、商品の出品は行いません。

3 ステップで開始できます：

1. 無料の Apify アカウントを登録します。
2. 上のインストールボタンをクリックするか、クライアントに次のサーバーアドレスを追加します。

   https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,get-dataset-list,zen-studio/goofish-xianyu-search-scraper,zen-studio/goofish-xianyu-item-detail-scraper,zen-studio/goofish-xianyu-seller-scraper,zen-studio/goofish-xianyu-visual-search-scraper,zen-studio/goofish-xianyu-item-comments-scraper
   

3. クライアントの案内に従って Apify にログインし、次のように質問します：「闲鱼で 5000～8000 元の中古 Sony A7 III ボディを検索し、個人販売者のみを対象に、検討に値する商品を上位 5 件、表形式で一覧にしてください。」

ヒント：検索キーワードには、販売者がタイトルで使っている表記を使用してください。中国ブランドは中国語（例：小米、华南金牌）で入力してください。ピンインでは一致しません。

ログインについて：Apify の認可ページには、このアプリが「動的に登録され、Apify による検証を受けていない」と表示され、API への完全なアクセス権限が要求されます。この方法でログインする AI アシスタントには、すべて同じ注意が表示されます。認可はいつでも Apify コンソールの統合ページで取り消せます。

料金：結果に応じて課金されます。詳細は上記の各ツールの Apify 料金ページをご覧ください。Apify の無料プランでは、各ツールの実行回数と、1 回の実行で取得できる結果数に上限があります（検索では最大 30 件）。有料プランでは、これらの制限はありません。

コードからの呼び出し：各ツールは Apify Actor です。REST API、Python または JavaScript クライアント、n8n、Make、Zapier から直接呼び出せます。例については、上記の コードから利用するをご覧ください。

よくある質問：

• 闲鱼のアカウントや中国の電話番号は必要ですか？ いいえ。Apify アカウントがあれば利用できます。
• 中国以外でも使えますか？ はい。どの国や地域からでも利用できます。
• 価格の変化を追跡できますか？ はい。同じ検索を AI アシスタントに繰り返し実行させて比較するか、Apify で定期実行を設定してください。
• 闲鱼の公式製品ですか？ いいえ。Goofish MCP は Zen Studio が独自に開発したもので、闲鱼、Goofish、Alibaba とは関係ありません。

Zen Studio のその他のサービス

Goofish MCP は Zen Studio の Apify Actors をベースに構築されています。各ツールは Apify 上で直接実行したり、API から呼び出したり、定期実行を設定したりできます。小红书（小红书）の投稿、コメント、クリエイターについては、RedNote MCPをご覧ください。

ライセンス

MIT。Goofish、Xianyu、Alibaba は、それぞれの所有者の商標です。