AmaShinan API

監視中のAmazon.co.jp検索順位と競合の変化を、Claude Code・OpenAI Codex・CursorなどのAIエージェント(SKILL・MCP対応含む)やお好みのツールから直接取得できます。Proプラン以上

できること

監視キーワードごとの最新順位を毎日のスキャン結果から取得
AI(Claude Code・OpenAI Codexなど)に「今週の順位の動きを表にして」と依頼するだけで自動集計・可視化
毎朝のレポートと同じデータを、あなたの好きな形で使う

クイックスタート

設定画面の「API連携」でキーを発行(1度だけ表示されます)
ターミナルで環境変数に設定:export AMASHINAN_API_KEY=ak_live_...

動作確認:

curl --fail-with-body --silent --show-error \
  -H "X-Api-Key: $AMASHINAN_API_KEY" \
  https://amashinan.com/api/v1/me

キーはパスワードと同じ扱いです。会話やSNS・Gitに貼らず、環境変数でのみ使用してください。漏れた場合は設定画面からすぐ失効できます。

エンドポイント

エンドポイント	内容	状態
`GET /api/v1/me`	プラン・ASIN数・キーワード数	利用可
`GET /api/v1/keywords`	監視キーワード一覧と最新順位	利用可
`GET /api/v1/rankings`	自社ASINの順位の時系列(`?keyword=`必須・30日まで)	利用可
`GET /api/v1/competitors`	競合カードの現在値(価格・評価・レビュー数・Prime・バッジ。`?keyword=`必須)	利用可
`GET /api/v1/events`	変化イベント(価格・評価・在庫・BSRなど。30日・500件まで)	利用可
`GET /api/v1/rufus/questions`	Rufusチェック用の質問5つ(監視キーワードから生成)	近日対応予定
`POST /api/v1/rufus/checks`	Rufus応答の提出とヒット判定(1日5問・週10問上限)	近日対応予定
`GET /api/v1/rufus/summary`	Rufusヒット率(SOV)のサマリー	近日対応予定
`GET/POST /api/v1/rufus/custom-questions`	カスタム質問の登録・一覧(AIエージェントが仮説から質問を作る)	利用可

順位データは1日1回(日本時間午前)のスキャンに基づきます。observed_atはUTC、local_dateは日本時間です。rankings/competitorsはkeyword指定が必須で、同時実行には上限があります(連続して押すと429が返ることがあります。少し待って再試行してください)。

利用の目安とエラー

制限・エラー	意味と対応
60リクエスト/分(変化イベントは10/分)	超過時は429+Retry-After秒待って再試行
401	キーが無効・失効。設定画面で再発行
403	プラン対象外(Pro以上で利用可)

手持ちデータとの統合(アクション提案)

スキルは取得した順位・競合データを、お手持ちのCSV(セラーセントラルの売上・広告レポート・在庫表・原価表など)と日付で突き合わせます。「順位は横ばいなのに注文が減った」「競合の値下げと自社の下落が同日か」のように、片方だけでは見えない原因を表にして、今日やること1つと3日後の判定条件まで提案します。

統合パターン	分かること
売上・注文数 × 順位	順位が効いていない期間の特定(CVR・価格の問題切り分け)
広告レポート × 順位	自然順位下落を広告で穴埋めしていないか
在庫表 × 変化イベント	在庫切れと順位下落・BSR悪化の日付一致
原価表 × 競合価格	上位価格帯との実質利益率比較

ファイルはAIが勝手に探さず、あなたが指定したものだけを読みます。数値の脚色は行わず、出所( API / お手持ちデータ )を表の中で区別して表示します。

Claude Code / Codex で使う(スキル)

下のボタンからスキルファイルをダウンロードし、スキル置き場へ保存すると(Claude Codeは~/.claude/skills/amashinan/SKILL.md、OpenAI Codexは~/.codex/skills/amashinan/SKILL.md)、「美容液の順位を表にして」のように話しかけるだけで取得・集計・グラフ化まで行えます。売上CSVなどを一緒に渡せば、上の統合分析(今日やることの提案まで)も行います。

SKILL.mdをダウンロード

Claude Code と OpenAI Codex の両方で使えます。キーの設定はダウンロード後、ターミナルで export してください(手順はファイル内に記載)。

はじめに

Proプランで始める / 料金を見る

AmaShinan トップへ戻る