2. 初期設定
最初に一度だけ、次の手順で設定します。所要時間はだいたい 10〜15 分です。
テンプレートをコピーする
配布された NEKOSOGI テンプレートのスプレッドシートを開き、メニューの「ファイル」→「コピーを作成」で自分の Google ドライブにコピーします。以後はこのコピーを使います。
設定ダイアログを開く
コピーしたシートを開き直すと、メニューバーに「NEKOSOGI」メニューが現れます。「⚙️ 設定」を選ぶと設定ダイアログが開きます。初回は Google の認可画面が出るので、内容を確認して許可してください。
SP-API 認証情報を入力する
「SP-API 認証（LWA）」欄に Client ID / Client Secret / Refresh Token の3つを入力します。 これらは Amazon のソリューションプロバイダーポータル（SPP）で 自己承認アプリを作成すると取得できます（Amazon 出品者アカウントと開発者登録が必要です）。
3つの値の取り方を詳しく見る（クリックで展開）
全体の流れは「SPP で開発者登録とアプリ作成（①〜③、初回のみ）→ 3つの値をコピー（④）」です。 初回は本人確認を含めて 30 分ほどかかります。
① 本人確認を完了する（初回のみ）
ソリューションプロバイダーポータルにログインすると、 「プロダクションアプリを作成するにはステップがあります」と表示されます。
まず左側の「本人確認」から「登録する」をクリックして本人確認を開始します。通常 20 分程度で完了します。
フォームでは主に以下の項目を入力します。
- 法人名（英語表記）: 個人事業主の場合は屋号の英語訳、法人の場合は法人名の英語訳を入力します。翻訳には AI を活用すると便利です。
- 法人名（日本語表記）: 個人事業主の場合は屋号または本名、法人の場合は日本語の法人名を入力します。
- 番号の入力: 法人番号 / 適格請求書発行事業者の登録番号 / 個人のマイナンバー（個人番号）のうち、該当するものを1つ入力します。
② アカウントプロフィールと権限を設定する（初回のみ）
本人確認が完了したら、右側の「ソリューションプロバイダーのアカウントプロフィールと権限の設定」から 「本人確認して開始します」をクリックし、開いたプロフィール設定画面で以下を入力します。
- 連絡先情報: 組織名、ウェブサイト、担当者名、メールアドレス、電話番号を入力します。
- データアクセス:
プライベートソリューションプロバイダーを選択します（自分で使うアプリのためプライベートを選びます）。 - ビジネスアクティビティの説明: 次のような文面を入力します。
「Amazon.co.jp で商品を販売しております。その業務における商品登録、価格改定、在庫管理などを自社アプリで構築したいと考えています。」 - ロール: 8つすべてにチェックを入れます。
- ユースケース: アプリの説明を入力します。ビジネスアクティビティの説明と同じ内容で構いません。
- セキュリティ管理: 質問はすべて「はい」を選択します。最後の2つの自由記述欄は、 「社外の関係者には情報を共有しておりません。」「外部ソースはありません。」のように回答します。
- 同意と登録: ページ下部の利用規約・データ保護ポリシーへの同意にチェックを入れて、「登録」をクリックします。
③ アプリクライアントを作成する（初回のみ）
ソリューションプロバイダーポータルにログインし、
新しいアプリクライアントを追加 を選びます。
| 項目 | 設定値 |
|---|---|
| アプリ名 | NEKOSOGI（任意の名前で構いません） |
| API タイプ | SP API |
| アプリタイプ | プロダクション |
| サポートされている企業 | 出品者 にチェック |
ロール選択画面では、8つすべてにチェックを入れてください。
PII の委譲は「いいえ」を選択し、保存して終了をクリックします。
④ 3つの値をコピーする
NEKOSOGI の設定ダイアログに貼り付ける値は以下の3つです。先にすべてメモ帳などにコピーしておくと、一気に貼り付けられてスムーズです。
| 値 | 取得元 |
|---|---|
| Client ID | SPP > アプリ一覧 > LWA認証情報 |
| Client Secret | 同上 |
| Refresh Token | SPP > 対象アプリ > ▼ > 承認 |
Client ID: アプリ一覧で LWA認証情報 の「表示」をクリックし、
クライアントID（amzn1.application-oa2-client.xxxxxxxx の形式）をコピーします。
Client Secret: 同じ LWA認証情報の画面で、クライアント機密情報の「表示」をクリックし、表示された値をコピーします。
Refresh Token: アプリ一覧で、対象アプリの「アプリの編集」右側にある ▼ をクリックし、「承認」を選択します。
「認可の管理」ページが開いたら、以下の2つを行ってください。
- リフレッシュトークン（
Atzr|xxxxxxxxの形式）の「コピー」をクリックする - SPP のアクション列にある「アプリを承認」ボタンを押して、認可を確定する
最後に、コピーした3つの値を NEKOSOGI の設定ダイアログ「SP-API 認証（LWA）」の各欄に貼り付ければ完了です。
Discord Webhook URL を入力する
通知を受け取りたい Discord チャンネルの「連携サービス」→「ウェブフック」から Webhook を作成し、URL をコピーして「通知」欄に貼り付けます。 作り方の詳細は Discord 公式の解説記事 をご覧ください。
保存して、サーバー連携する
「保存」を押してから「サーバー連携」を押します。利用資格の確認が通ると「連携済み ✓」と表示され、5分ごとの巡回が始まります。
接続テストで確認する
「接続テスト」を押すと、SP-API の認証・価格取得・Discord への テスト通知を順に確認して結果を表示します。すべて ✓ になれば設定完了です。
設定ダイアログの項目
| 項目 | 説明 |
|---|---|
| Client ID / Client Secret / Refresh Token | SP-API（LWA）の認証情報です。保存済みの場合は「保存済み」と表示され、空のまま保存すると現状維持になります。 |
| Discord Webhook URL | 通知の届け先です。https://discord.com/api/webhooks/... の形式のみ受け付けます。 |
| 再通知クールダウン（分） | 同じ商品への通知を再送するまでの待ち時間です（初期値 60 分）。詳しくは 通知の見方 をご覧ください。 |
| ビジネス価格も監視する | オンにすると、Amazon Business の価格も監視対象になります。 |
| 監視を一時停止する | オンにすると、連携したまま巡回・通知を止められます。 |
| サーバー連携 / 連携解除 | 連携すると巡回が始まります。解除すると、サーバー側に保存された認証情報とウォッチリストは削除されます。 |
| 最終巡回時刻 | サーバーが最後に価格を確認した時刻です。連携後、巡回が動いているかの目安になります。 |