mcpField
L
linkfox-amazon-policy-feed

linkfox-amazon-policy-feed

github.com/linkfox-ai生産性113317 回インストール2 週間前に更新
リポジトリ

linkfox-amazon-policy-feed について

越境販売者向けに、Amazon の公式ポリシーや規制の更新情報を取得するスキルです。ページ分けされた一覧と記事本文を別々に取得でき、中国語の AI 要約やサイト・公開日時の絞り込みに対応します。

主な機能

  1. 01サイトと期間による絞り込み
  2. 02ポリシー更新のページ閲覧
  3. 03記事の Markdown 全文取得
  4. 04中国語 AI 要約の表示

活用シーン

  1. 01最近の Amazon 販売者向けポリシーの確認
  2. 02サイトと日付を指定した更新情報の検索
  3. 03一覧にある更新情報の全文確認

MCP 対応

`amazon/policyFeed` でポリシー情報を一覧表示し、`amazon/policyFeedDetail` で選択したレコードの本文を取得します。

インストール

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

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-amazon-policy-feed

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

同梱ファイル

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

references/
api.md
onboarding.md
scripts/
amazon_policy_feed_detail.py
amazon_policy_feed.py
onboarding.py

詳細

Amazon Policy & Regulation Feed

このスキルは、越境販売者向けに Amazon の最新のポリシーと規制フィードを取得します。2段階(一覧取得後に詳細取得)のフローです。まずサイト/期間でフィード項目を一覧表示し、次にそのidを使って記事本文全体を取得します。

主な概念

  • ソース:販売者向けの Amazon 公式ポリシーと規制の更新情報です。越境業務に役立つ項目を表示するため、AI が選定しています。
  • AI による要約:各フィード項目にはsummaryZhフィールドが含まれています。項目をすばやく確認するための、AI が生成した中国語の1~3文の要約です。
  • 連携する2つのツール:
    1. amazon/policyFeed — ページネーション対応の一覧取得です。タイトル、AI による要約、元の URL、公開日時を含む構造化レコードを返します。
    2. amazon/policyFeedDetail — 一覧から取得した単一レコードのidを指定して、記事の本文全体(Markdown)を取得します。
  • 期間:デフォルトは過去7日間です。publishedAtGte/publishedAtLteで期間を指定できます。

パラメーター

一覧(amazon/policyFeed)
パラメーター型必須説明デフォルト
sitestringいいえマーケットプレイスコード(大文字)。サイトによるフィルタリングは一部のフィード項目にのみ適用され、その他の項目はサイトに関係なく常に返されますUS
publishedAtGtestringいいえ公開/変更日時の下限(含む)、yyyy-MM-dd HH:mm:ss過去7日間
publishedAtLtestringいいえ公開/変更日時の上限(含む)、yyyy-MM-dd HH:mm:ss現在
pageintegerいいえページ番号。1から始まります1
pageSizeintegerいいえ1ページあたりの項目数、1~10020
詳細(amazon/policyFeedDetail)
パラメーター型必須説明
idstringはい一覧レスポンスのdata[].idに含まれるレコード ID(32文字の文字列)
対応マーケットプレイス(site用)

US、JP、UK、AU、BE、BR、CA、EG、FR、DE、IN、IT、MX、NL、PL、SA、SG、ES、SE、TR、AE、ZA、IE。指定がない場合、デフォルトはUSです。注:siteによるフィルタリングは一部のフィード項目にのみ適用され、その他の項目はサイトに関係なく常に返されます。

呼び出し方法

  • API エンドポイント:
    • POST /amazon/policyFeed(amazon_policy_feed.py。全パラメーター/レスポンス/エラーコードはreferences/api.mdを参照)
    • POST /amazon/policyFeedDetail(amazon_policy_feed_detail.py。全パラメーター/レスポンス/エラーコードはreferences/api.mdを参照)
  • Python スクリプト:python scripts/<脚本名>.py '<JSON 参数>' [--inline]
  • コスト制限:このツールは計算リソースを消費します。同一セッション内で同一のパラメーターの組み合わせを指定した場合、デフォルトでは1回のみ呼び出します。スクリプトには24時間のローカルキャッシュがあります。失敗または空の結果が返された場合、キーワードを自動的に変更したり、ページを切り替えたり、連続して試行したりしてはいけません。検索を続ける必要がある場合は、追加コストが発生することを先にユーザーに伝えてください。

出力方針(スクリプトのデフォルト動作):

  • 常に完全なレスポンスを<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-policy-feed-<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を使って必要なデータを抽出してください。

認証と計算リソースの問題への対処

次の異常が発生した場合は、references/onboarding.mdの案内に従って問題を解決してください。

異常な状況
  • API Key が未設定:環境変数LINKFOX_AGENT_API_KEYもLINKFOXAGENT_API_KEYも設定されていません。
  • 401または402のステータスコードが返された
  • 計算リソースまたは残高不足を示すレスポンス:メッセージに「計算リソースの残高不足/請求不足/残高不足/クォータ超過/残高不足/プランの有効期限切れ/チャージが必要/チャージしてください」または類似の意味の内容が含まれています。

クエリの作成方法

  1. 期間を設定する:ユーザーの期間指定をpublishedAtGte/publishedAtLteに変換します。デフォルトの過去7日間を使う場合は空欄にします。
  2. マーケットプレイスを選択する:ユーザーの対象国をsiteコードに対応付けます(デフォルトは US)。この指定でフィルタリングされるのは一部のフィード項目のみです。
  3. ページネーションを行う:より多くの項目を確認するには、pageを増やします。1ページあたりの最大件数は100件です。
  4. レコードの詳細を確認する:一覧からレコードのidを取得し、詳細取得スクリプトを呼び出して本文全体を読み取ります。
使用例

1. 最近のフィード(過去7日間、US)

{"site": "US", "pageSize": 20}

2. カスタム期間

{"site": "US", "publishedAtGte": "2026-05-01 00:00:00", "publishedAtLte": "2026-05-31 23:59:59"}

3. 日本サイトのフィード、2ページ目

{"site": "JP", "page": 2, "pageSize": 50}

4. 1件のレコードの本文全体

{"id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"}

表示ルール

  1. 一覧表示:タイトル、AI による要約(summaryZh)、公開日時、元の URL リンクを含む表として結果を表示します。
  2. 詳細表示:stdout の Markdown をそのまま表示します。応答には、文脈を把握できるよう title と summaryZh も含めます。
  3. データのみを提示:フィードに記載されている内容を報告します。主観的なビジネス上のアドバイスを加えたり、今後の方針を推測したりしないでください。
  4. 最新性に関する注意:データはライブページより少し遅れている場合があります。Amazon の元データを正としてください。
  5. エラー処理:呼び出しに失敗した場合、推測せず、エラー応答から理由を説明します(例:無効な id の場合は、一覧から再取得します)。

重要な制限事項

  • デフォルトの期間は7日間:期間パラメーターを明示しない場合、直近7日間のみが返されます。
  • 1ページあたり最大100件:pageSize の範囲は1~100です。
  • 詳細表示には有効な一覧の id が必要:amazon/policyFeedDetail が受け付けるのは、amazon/policyFeed が返した id のみです。不明な ID はエラーになります。
  • 集計には不向き:このスキルの出力は長文テキストとメタデータのため、_dataQuery_executeDynamicQuery を使った二次的な統計・集計分析には適していません。

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

適用対象 — Amazon の公式ポリシー・規制フィード:

ユーザーの発言シナリオ
「最近亚马逊有什么政策变化」最近のポリシー変更の概要
「亚马逊美国站近一周的政策新闻」サイトを指定したポリシーニュース
「亚马逊最近有什么政策法规更新」ポリシー・規制の一般的な更新情報
「亚马逊 FBA 最新政策法规」トピックを指定したポリシー検索
「查看这条政策资讯的全文」ID を指定して記事全文を取得
「Amazon latest policy updates」英語でのトリガー

適用対象外 — ポリシー・規制フィードの範囲外:

  • 商品・キーワード・売上分析、商品リストの最適化、レビュー分析
  • リアルタイムのストアフロント検索結果や商品詳細
  • 個々の販売者アカウント内のアカウント固有の通知
  • 過去の特許・商標検索

適用範囲の判断:ユーザーが Amazon の販売者向けに公式発表されたポリシー、規制、コンプライアンスの更新情報(およびその全文)を求めている場合、このスキルが適用されます。商品・キーワード・売上データを求めている場合は、該当するデータスキルを使用してください。

算力消耗ルール

15 算力を消耗します。

ユーザーは算力の消耗に応じて料金を支払います。十分に検討してください。このスキルを高頻度で呼び出す必要がある場合や、ユーザーが算力の消耗量を十分に把握していない場合は、必ずユーザーに注意を促し、続行するかどうかをユーザーに判断してもらってください。

フィードバック:

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

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

references/api.md に記載されている手順に従ってフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。


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

コメント