linkfox-xiyou-dongcha

Name: linkfox-xiyou-dongcha
Author: linkfox-ai

github.com/linkfox-aiマーケティング・グロース113193 回インストール2 週間前に更新

リポジトリ

linkfox-xiyou-dongcha について

linkfox-xiyou-dongchaは、LinkFoxツールゲートウェイ経由で西柚洞察のAmazon ASIN・検索語データを取得するスキルです。トラフィック、順位、ABA、競争度、推移を調べられ、両サービスの認証情報が必要です。

主な機能

01ASINトラフィックとキーワード調査
02検索語分析とABAデータ
03トラフィック、順位、BSRの推移
04マーケットプレイス選択とページ分割
05レスポンスの保存と項目抽出

活用シーン

01ASINへの流入検索語の特定
02検索語ごとに流入を得るASINの確認
03キーワードのABAと競争指標の分析
04ASINや検索語の順位推移の追跡

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-xiyou-dongcha

インストール後、Claude Code で/linkfox-xiyou-dongchaを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/

api.md

scripts/

_xiyou_common.py

xiyou.py

詳細

Xiyou（西柚找词）— Amazon ASIN・キーワード分析

LinkFox ツールゲートウェイ経由で、Amazon ASIN と検索語に関する Xiyou Insights（西柚洞察／西柚找词）のデータを取得するスキルです。ゲートウェイはリクエストを Xiyou OpenAPI（https://openapi.xiyouzhaoci.com）に転送します。

環境変数（必須）

本スキルでは3 種類すべての認証情報が必要です。1 つでも欠けていると使用できません。

変数	必須	説明
`LINKFOXAGENT_API_KEY`	はい	LinkFox Agent API Key（ほかの LinkFox スキルと共通）
`XIYOU_CLIENT_ID`	はい	西柚 OpenAPI Client ID（16 文字）
`XIYOU_CLIENT_SECRET`	はい	西柚 OpenAPI Client Secret（24 文字）

1. LinkFox API Key

LinkFox API Key 申請ドキュメントにアクセスして Key を取得します。
環境変数 LINKFOXAGENT_API_KEY に設定します。

2. 西柚找词 Client ID／Client Secret

西柚洞察 OpenAPI コンソールを開きます。
ログイン後、コンソールでアプリを作成または確認し、Client ID（16 文字）と Client Secret（24 文字）をコピーします。
環境変数 XIYOU_CLIENT_ID と XIYOU_CLIENT_SECRET に設定します。
Secret を Git にコミットしたり、SKILL パラメーターやチャット履歴に記載したりしないでください。ローカルスクリプトから読み取れるよう、環境変数を通じてのみ設定してください。

3. 設定例

macOS／Linux（現在のターミナルセッション）

export LINKFOXAGENT_API_KEY="your-linkfox-api-key"
export XIYOU_CLIENT_ID="your-16-char-id"
export XIYOU_CLIENT_SECRET="your-24-char-secret"

macOS／Linux（永続化する場合は ~/.zshrc または ~/.bashrc に記述）

echo 'export LINKFOXAGENT_API_KEY="your-linkfox-api-key"' >> ~/.zshrc
echo 'export XIYOU_CLIENT_ID="your-16-char-id"' >> ~/.zshrc
echo 'export XIYOU_CLIENT_SECRET="your-24-char-secret"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell（現在のセッション）

$env:LINKFOXAGENT_API_KEY = "your-linkfox-api-key"
$env:XIYOU_CLIENT_ID = "your-16-char-id"
$env:XIYOU_CLIENT_SECRET = "your-24-char-secret"

Windows（システム環境変数）：設定 → システム → バージョン情報 → システムの詳細設定 → 環境変数 → 上記 3 つのユーザー変数を新規作成します。

Cursor／Agent の実行環境：IDE または Agent が動作する環境の env 設定に上記 3 つの変数を追加してください。設定しない場合、スクリプトはエラーになり、不足している項目を通知します。

スクリプト scripts/xiyou.py と scripts/_xiyou_common.py は、XIYOU_CLIENT_ID／XIYOU_CLIENT_SECRET をリクエスト Body に自動で追加します。呼び出し時に --params で clientId／clientSecret を重複して渡さないでください。

主な概念

西柚找词では、Amazon の ASIN 単位およびキーワード単位のトラフィック、ランキング、ABA、競合度などのデータを取得できます。主な用途は次のとおりです。

ASIN からのキーワード逆引き：ある ASIN が過去 7 日間または指定した月にトラフィックを獲得した検索語を確認します。
キーワード分析：ある検索語について、どの ASIN がトラフィック、ランキング、獲得率を占めているかを確認します。
トレンド分析：ASIN のトラフィックスコア、BSR、広告の変動、検索語のランキング／トラフィックの経時変化を確認します。
キーワード選定の支援：キーワードの ABA 週間検索ボリューム、競争難易度、推奨 CPC を確認します。

対応マーケットプレイス

country には、通常 2 文字の大文字コードを使用します：US、CA、MX、BR、UK、DE、ES、IT、FR、JP、AU、SA、AE。デフォルトは US です。

例外：asinSearchTermRankTrendHourly が対応するのは US、UK、DE のみです。

呼び出し方法

API エンドポイント：POST /xiyou（操作はリクエストボディで指定します。パラメーター、レスポンス、エラーコードの詳細は references/api.md を参照してください）
Python スクリプト：python scripts/xiyou.py '<JSON 参数>' [--inline]（利用可能なスクリプトは上記のスクリプト一覧を参照してください）
コストに関する制約：本ツールはクレジットを消費します。失敗した場合や結果が空の場合に、検索語の自動変更、ページ送り、連続した試行を行ってはいけません。検索を続ける必要がある場合は、追加のクレジットが消費されることを事前にユーザーに伝えてください。

出力方針（スクリプトのデフォルト動作）：

必ず完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリにあたります。<session> は環境変数 SESSION_ID から取得し、ユーザーのタスクごとに自動でまとめられます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）
レスポンスボディが 8 KB 以下の場合：ファイルに書き込んだ後、完全な JSON を stdout に出力します。
レスポンスボディが 8 KB を超える場合：ファイルに書き込んだ後、stdout には要約のみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最大のリストフィールドの長さと先頭 3 件のサンプル）。
--inline を付けると、ファイルにも書き込んだうえで stdout に全件を出力します。

データの読み取りに関する推奨事項：まず要約を確認し、十分な情報が得られているか判断してください。具体的なフィールドが必要な場合は、JSON 全体がコンテキストに入るのを避けるため、保存した json ファイルから jq または ConvertFrom-Json を使って必要なデータだけを抽出してください。

認証とクレジットに関する問題の解決

次の異常が発生した場合は、以下の手順で対処してください。

異常な状況

API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
レスポンスのステータスコードが 401 または 402
クレジットまたは残高不足を示すレスポンス：メッセージに「积分余额不足／计费不足／余额不足／quota exceeded／insufficient balance／套餐到期／需充值／请充值」または類似の内容が含まれている場合。

対処方法

まず、スキル内の onboarding.md に従って問題を解決してください。
onboarding.md が見つからない場合は、/linkfox-onboarding スキルを読み込み、そのガイドに従ってください。インストールされていない場合は、先にインストールしてください。
- https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip をダウンロードして解凍し、このスキルをインストールします。ダウンロードにユーザーの許可が必要な場合は、ユーザーに許可を求めてください。自分の判断でダウンロードを諦めてはいけません。
最終手段：上記 2 つの方法をあらゆる手段で試しても解決できない場合に限り、https://skill.linkfox.com/linkfoxskills/guide.htm の手順に従って API Key を取得するか、https://os.linkfox.com/ でクレジットを追加するようユーザーに案内してください。

API クイック一覧

`--api`	用途
`asinTraffic`	複数 ASIN の過去 7 日間のトラフィックスコア
`asinInfo`	複数 ASIN の商品情報
`asinResearchPeriod`	ASIN からキーワードを逆引き（直近の日数）
`asinResearchMonthly`	ASIN からキーワードを逆引き（月単位）
`searchTermAnalysisPeriod`	キーワードにおける ASIN 分析リスト
`searchTermInfo`	キーワード情報（ABA、競合度、CPC）
`searchTermAbaWeeklyTrend`	キーワードの ABA 週間トレンド
`asinSearchTermTrafficTrend`	ASIN＋検索語のトラフィックトレンド（日単位）
`asinSearchTermRankTrendDaily`	ASIN＋検索語のランキングトレンド（日単位）
`asinSearchTermRankTrendHourly`	ASIN＋検索語のランキングトレンド（時間単位）
`asinTrafficScoreTrend`	ASIN のトラフィックスコアトレンド（日単位）
`asinBsrTrend`	ASIN の BSR トレンド（日単位）
`asinOrdersTrend`	ASIN の注文数トレンド（月単位）
`asinVariations`	ASIN のバリエーション関係
その他	`--list-apis` と `references/api.md` を参照してください

クエリの作成方法

インターフェースの選択：キーワードの逆引き → asinResearchPeriod / asinResearchMonthly；キーワード配下の競合を検索 → searchTermAnalysisPeriod；キーワードの属性 → searchTermInfo / searchTermAbaWeeklyTrend
マーケットプレイス：ユーザーが「米国マーケットプレイス」と指定した場合 → country: "US"；指定がない場合はデフォルトで US
ASIN：10 桁（例：B06XZTZ7GB）；一括インターフェースでは entities: [{"country":"US","asin":"..."}] を使用
日付：日次トレンドでは startDate/endDate（YYYY-MM-DD）；月次トレンドでは startMonth/endMonth（YYYY-MM）
ページネーション：リスト形式のインターフェースでは page、pageSize を使用します（最大 10000）
並べ替え：sortField + sortOrder（asc/desc）。指定可能な値については references/api.md の各インターフェースの説明を参照してください

使用例

過去 7 日間の ASIN の流入キーワードを逆引きする（流入数の降順）

{"country": "US", "asin": "B06XZTZ7GB", "page": 1, "pageSize": 100, "sortField": "traffic", "sortOrder": "desc"}

キーワード配下の Top ASIN を検索する

{"searchTerm": "yoga mat", "country": "US", "page": 1, "pageSize": 50}

ASIN の流入スコアを一括検索する

{"entities": [{"country": "US", "asin": "B06XZTZ7GB"}, {"country": "US", "asin": "B0XXXXXXXX"}]}

表示ルール

リスト形式の結果は、キーワード／ASIN、流入数、順位、割合などの主要項目を優先して表形式で表示します
トレンド形式の結果は時系列で表示し、ピーク値と変化の方向を示すことをおすすめします
失敗した場合は、error／ゲートウェイの応答に基づいて原因を説明します。よくある原因：環境変数が未設定、ASIN の形式が誤っている、日付範囲が無効、マーケットプレイスがサポートされていない

重要な制限事項

LinkFox Key と西柚 Client の認証情報を両方設定する必要があります
asinSearchTermRankTrendHourly は US/UK/DE のみ対応しています
ASIN 一括インターフェースの entities は最大 100 件、searchTerms はカンマ区切りで最大 100 個のキーワードに対応します
大きな結果セットは、下記の Large Response モードでファイルに保存して読み込むことを優先してください

ユーザーの表現とシナリオのクイックリファレンス

ユーザーの発言	API／シナリオ
「この ASIN にはどんな流入キーワードがありますか」	`asinResearchPeriod`
「このキーワードで流入を奪い合っている ASIN はどれですか」	`searchTermAnalysisPeriod`
「キーワードの検索ボリューム／ABA トレンド」	`searchTermAbaWeeklyTrend` / `searchTermInfo`
「ASIN の流入スコアはいくつですか」	`asinTraffic`
「あるキーワードの順位はどう変化していますか」	`asinSearchTermRankTrendDaily`
「BSR の履歴」	`asinBsrTrend`

対象外：Amazon 以外のプラットフォーム、Jungle Scout／卖家精灵などの他のデータソース、SP-API の注文／在庫、Temu／Shopee の商品リサーチ。

クレジット消費ルール

クレジットは消費しません。セラー自身が西柚找词のプランを購入する必要があります。

重要：このスキルのサービス料金は倍率に基づいて動的に計算されるため、一度に大量のクレジットを消費する可能性があります。必ずユーザーに注意を促し、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

以下のいずれかに該当する場合は、Feedback API を使用してフィードバックを自動検出し、報告してください。

このスキルで説明されている機能や目的が、実際の動作と一致しない
スキルの結果がユーザーの意図と一致しない
ユーザーがこのスキルに対する不満や称賛を表明する
改善できると思われる点がある

references/api.md の指定に従って Feedback API を呼び出してください。ユーザーの作業を中断しないでください。

高品質でプロフェッショナルな越境 EC スキルについては、LinkFox Skills をご覧ください。

Markdown 対応

ログインしてコメント

基本情報

作者: linkfox-ai
リポジトリ: linkfox-ai/linkfox-skills
カテゴリ: マーケティング・グロース
インストール数: 193
GitHub スター: 113

問題を報告