PROMPTS
プロンプト集
すべてのプロンプトは「目的 → 入力 → 処理 → 出力 → 受け入れ基準」の同じ形です。キットのフォルダを AI ツールで開いて使うのが基本ですが、ここからコピーしても同じ内容です(キットのファイルから自動生成しています)。
01
共通ルール:AGENTS.md
Codex などはフォルダを開くと自動で読みます。読まれない場合は「AGENTS.md を読んで従って」と最初に指示
共通ルールを読む・コピーするAGENTS.md
AGENTS.md
# AGENTS.md — AliExpress アフィリエイト AI 成長キット v2
このフォルダで作業する AI エージェント(Codex / Qoder / Claude Code など)は、以下を**必ず**守ってください。
目的は「成約につながる正確な情報を、速く・継続的に出すこと」です。見た目のサイトを作ることは手段です。
## 1. データの扱い(最重要)
1. **データを作らない。** 価格・在庫・クーポン・期限・送料・レビュー・実績値を推測・補完・生成しない。不明な値は `null` のまま残し、`missing_fields` に書く。
2. **使ってよいデータ**は「公開情報」と「サイト運営者または運営側が許諾を得て、その用途での利用が認められたプラットフォームデータ」のみ。非公開のレポートや数値を記事・SNS・画面に転記しない(`evidence.visibility = "internal"` は参照のみ)。
3. データは `schema/*.schema.json` の契約に従う。スキーマの必須キーを残す。`null` 可の未確認値は null、それ以外の欠落は不足として報告して下書きに留める(仮値で埋めない)。
4. 状態は三値。`unknown` は `expired` / `out_of_stock` と同じではないが、**確認できるまで公開しない**。
5. 対象は **AliExpress 日本向けアフィリエイト**。淘宝・天猫・DS API の仕様を流用しない。この JSON は本キットの正規化契約であり、AE API の生レスポンスではない。
6. 商品 ID と SKU ID は文字列で保存し、指定 SKU の価格・在庫・日本配送を確認する。商品全体の最低価格・合計在庫で代用しない。API の `lastest_volume` は販売数、Code の `code_quantity` は利用残数であり、在庫ではない。
7. `affiliate_status` は現在の根拠で `affiliate / non_affiliate / unknown` を記録し、`affiliate_verified_at` を添える。検索に出ない・通信失敗・フィールド欠落を非アフィリエイトと判定しない。`is_hot_product`(マーケティング対象)とは別に扱う。
8. 内部データ、他のパートナーの非公開実績、社内システムの照会方法・SQL・テーブル名、認証情報、個人のファイルパスを外部向け生成物に含めない。API 署名や S2S 受信は静的サイトではなく、許諾されたサーバー側で処理する。
## 2. 公開ゲート(バリデータが最終判断)
- 公開前に必ず実行する:
`node validator.js <データ> --mode production --out <出力>/publishable.json --strict`
- サイト・記事・SNS 投稿に使ってよいのは **`publishable.json` に含まれるレコードだけ**。元データを直接描画しない。
- あなたの判断(`publish_decision`)は参考意見。バリデータが `error` を出したものは公開しない。
- `is_sample: true` のデータは本番に出さない。
- 画面では `display.hide_after` を過ぎたレコードを非表示にする(再ビルドを待たない)。
## 3. 価格表示
- 商品価格のラベルは「ページ価格」「検証済み割引後の商品価格」「◯点購入時の検証済み合計」。未適用の特典は「条件付き特典」として価格とは別に表示する。
- しきい値(例:15,000円以上)を満たさないクーポンを単品価格に入れない。条件付き特典として別表示する。
- 複数点購入の合計を出す場合は点数と按分方法を明記する(`display.per_unit_note_ja`)。
- 送料が不明なら「送料:要確認」。確認できていない「送料込み」「最安値」「No.1」は使わない。
- 価格の横に確認日時(`display.verified_label_ja`)を表示する。
## 4. リンクと計測
- 基本は公式生成リンクを無加工で使用し、`link_policy.original_url` に原本、`mode: "official_original"` を保存する。公式原本に存在するクエリを一律に削除しない。
- 例外は開通・設定済み S2S の公式透伝 af / cn / cv / dp。`mode: "s2s"`、`s2s_configured: true` を記録する。af は登録済みサブアフィリエイトのみ(`sub_affiliate_registered: true`)。元リンクを変えず、重複キーや未知パラメータを追加しない。
- dp 等に個人情報を入れない。opaque なクリック ID を使い、対応表は非公開に保つ。キットの文字種制限は保守的な公開ゲートであり、AE の全パラメータ仕様そのものではない。
- チャネル別計測はポータル・公式ツール・設定済み S2S の実際の構成を `channels` に記録する。計測方法が none の場合は tracking_value を null にする。
- 遷移、S2S 接続テスト、支払通知、成果帰属、精算完了は別々に確認する。クリック成功や接続テストで報酬を保証しない。
## 5. 表現・コンプライアンス
- すべてのページ・投稿に PR 表記(アフィリエイト広告を含む旨)を入れる。
- 実購入レビューは購入記録(`purchase_record`)がある場合のみ。
- 画像は権利が確認できたもの(`image.rights ≠ unknown`)のみ。
- 更新日は実質的な変更があったときだけ変え、`update_note_ja` に内容を書く。
- 構造化データや更新日でリッチリザルト・順位向上が保証されるとは書かない。
## 6. 出力フォーマット(全プロンプト共通)
作業結果は次の JSON エンベロープで返す(コードやファイル変更とは別に):
```json
{
"task": "04a_coupon_flash",
"publish_decision": "publish | draft | block",
"content": "生成物(Markdown / HTML / 投稿文)",
"data_patch": [],
"evidence_refs": ["EV-..."],
"missing_fields": ["products[PR-X].shipping_fee"],
"reasons": ["判断理由を短く"],
"human_review": ["人が確認すべき点"]
}
```
根拠が足りない場合は `block` ではなく `draft` とし、何が足りないかを `missing_fields` に具体的に書く。
## 7. 作業の進め方
1. `README.md` を読み、ユーザーの経路(新規サイト/既存サイト/SNS)を確認する。
2. データ → `node validator.js` → `publishable.json` → 生成・描画、の順を崩さない。
3. 変更後は `node test.js` と `node validator.js sample --now 2026-11-18T12:00:00+09:00` が通ることを確認する。
4. 各シナリオの詳細手順は `prompts/` を参照。02
出力エンベロープ
AI の作業結果を同じ形で受け取り、人とバリデータが確認しやすくする
| キー | 中身 | 確認のポイント |
|---|---|---|
task | 実行したプロンプト名 | |
publish_decision | publish / draft / block | AI の意見。最終判断はバリデータの結果とあなた |
content | 生成物(Markdown / HTML / 投稿文) | 価格文言が display のものと一致しているか |
data_patch | dataset.json への変更 | 推測で埋めた値がないか |
evidence_refs | 使った根拠の ID | 内容の主張すべてに根拠があるか |
missing_fields | 確認できなかった項目 | 次に確認する作業リストとして使う |
reasons / human_review | 判断理由/人が見るべき点 | 公開前に必ず目を通す |
根拠が足りないときは
block ではなく draft にして、何が足りないかを missing_fields に具体的に書かせます。止めるだけでなく「次に何を確認すれば公開できるか」がわかる状態にするためです。03
どのプロンプトをいつ使うか
番号順がおおよその作業順です
| 段階 | プロンプト | 使うとき |
|---|---|---|
| 供給 | 01 供給パックの取り込み 02 商品の優先順位づけ 03 価格シナリオの作成 | 新しい商品・特典を受け取ったとき/価格・特典が変わったとき |
| 生産 | 04a クーポン速報 04b セール攻略 04c カテゴリ定番・選び方 04d 実購入レビュー 04e はじめてガイド | 読者の購買段階に合わせて記事を作るとき |
| 配信 | 05 配信と拡散 | SNS・LINE・メールに展開するとき |
| 成長 | 06 週次レビュー | 週 1 回、成果データで改善点を決めるとき |
| サイト | 07 新規サイトの構築 08 既存サイトへの組み込み | 最初の構築時/デザイン・構成を変えるとき |
04
シナリオ別プロンプト
クリックで展開。右上のボタンでコピー
01 供給パックの取り込み(supply intake)prompts/01_supply_intake.md
prompts/01_supply_intake.md
# 01 供給パックの取り込み(supply intake) ## 目的 運営側や自分で集めた商品・特典・素材・キャンペーン情報を、契約どおりの `data/dataset.json` に変換する。ここで誤った値を入れると後工程すべてが誤るため、**推測で埋めない**ことが最優先。 ## 入力 - 供給パック(CSV / スプレッドシート / テキスト / スクリーンショットの書き起こし など) - 商品プール:item_id、SKU、タイトル、カテゴリ、ストア、ページ価格、在庫、日本配送、送料 - 特典:種類、割引額/率、上限、利用条件額、対象(サイト/ストア/商品)、対象ユーザー、期間、併用可否 - 素材:画像 URL と利用権限 - キャンペーン:名称、期間、関連特典 - リンク:ポータル/公式ツールで生成済みのアフィリエイトリンク - 確認日時と根拠(ページ確認、スクリーンショット、ポータル出力 など) ## 処理 1. `schema/` の契約を読み、各値を対応するキーに入れる。**必須キーを残し、null 可の不明値は `null`**。null 不可の欠落は不足として報告し、仮値を入れず下書きに留める。 2. 状態は三値で記録:在庫 `in_stock / out_of_stock / unknown`、特典 `active / expired / unknown`。確認できない場合は `unknown`。 3. 日時はタイムゾーン付き(例 `2026-11-18T09:30:00+09:00`)。 4. 根拠ごとに `evidence` を 1 件作成。社外に出せない資料は `visibility: "internal"`。 5. 価格シナリオ(`scenario`)は `prompts/03_price_scenario.md` に従って作る。迷ったら `price_type: "page_price"`・特典なしで登録し、特典は `conditional_offer_ids` に入れる。 6. `affiliate_url` と `link_policy.original_url` に公式生成リンクを保存する。通常は `mode: "official_original"`、`s2s_configured: false`、`sub_affiliate_registered: false`。開通・設定済み S2S の場合のみ `mode: "s2s"` とし、許可された af / cn / cv / dp を追記する(af はサブアフィリエイト登録が必要)。未知パラメータを生成・削除しない。 - 本 JSON はキットの正規化契約であって AE の生レスポンスではない。`product_id` → `item_id` は同じ商品であることを確かめて変換する。長い ID は文字列。 - 日本の設定は JA / JPY / JP。`product.query` の国は `ship_to_country`、`productdetail.get` は `country`。他のインターフェースへ同じ引数名を流用しない。 - 基本 API の target_sale_price 等を選択 SKU の page_price と同一視しない。SKU と日本配送を照合する。lastest_volume / code_quantity を在庫に使わない。 - `affiliate_status`、`affiliate_verified_at`、`is_hot_product` を分離する。Portals 確認は isSuccess=true かつ isAffiliateItem が明示された場合のみ判定。検索欠落・エラーは unknown。 - API 未開通なら商品ページ・Portals の通常操作で確認し、許諾されたレスポンスから必要項目だけ抽出する。`source-normalizer.js` は保存 JSON のローカル解析専用。認証・リクエスト送信・制限回避は行わない。 7. `node validator.js data --now <確認時刻>` を実行し、エラーを一覧化する。 ## 出力 - `data/dataset.json` の差分(`data_patch`) - エンベロープ(`AGENTS.md` §6)。`missing_fields` に未確認項目を具体的に列挙(例:`products[PR-12].ship_to_jp`)。 ## 受け入れ基準 - [ ] スキーマエラー(S00)が 0 件 - [ ] 推測で埋めた値がない(不明は null/unknown) - [ ] すべての商品・特典に根拠(evidence_ids)がある - [ ] 公式リンク原本を保存し、通常無加工・設定済み S2S の許可追記のみ - [ ] 同じ SKU・日本配送・JPY・現在のアフィリエイト資格を確認し、検索欠落や通信失敗を N / 在庫ゼロに置換していない - [ ] 業務ルールのエラーは「データの誤り」か「本当に公開できない状態」かを区別して報告している
02 商品の優先順位づけ(scoring)prompts/02_scoring.md
prompts/02_scoring.md
# 02 商品の優先順位づけ(scoring) ## 目的 公開可能な商品の中から、**成約につながりやすい順**に掲載・記事化の優先度を決める。GMV は「訪問数 × アフィリエイト出口クリック率 × クリック後の成約率 × 平均注文額」で分解でき、各要素に効く商品を選ぶ。 ## 入力 - `publishable.json`(バリデータ通過済みのデータのみ) - 任意:自分のサイト・アカウントの成果データ(許諾された範囲。クリック、注文、売上 など) - 任意:季節・イベント・検索需要などの公開情報 ## 処理 1. 各商品を次の観点で 1〜5 点で評価し、**根拠を一文ずつ**添える。 | 観点 | 主に効く要素 | 例 | |---|---|---| | 需要・時期 | 訪問数 | 季節需要、セール期間、検索されやすい用途 | | 価格の分かりやすさ | クリック率 | 検証済み割引後価格がある、条件付き特典が明確 | | 特典の使いやすさ | 成約率 | しきい値が低い、対象が全員、期限に余裕 | | 確実性 | 成約率 | 在庫・日本配送・送料が確認済み | | 内容との相性 | クリック率 | 比較・選び方・レビュー記事を作れる情報量 | | 注文額 | 平均注文額 | セット購入やしきい値到達の提案がしやすい | | 自分の実績 | 全体 | 過去のクリック・成約(十分なサンプルがある場合のみ) | 2. 実績データが少ない場合(目安:クリック 100 未満)は「実績」を評価に使わず、`reasons` にその旨を書く。 3. 合計点ではなく、**どの要素を伸ばす商品か**(集客用/成約用/単価向上用)を分類する。 ## 出力 - 優先順位表(商品 ID、分類、各観点の点数と根拠、推奨コンテンツ種別 04a〜04e) - エンベロープ。社外に出せない数値は `content` に含めない。 ## 受け入れ基準 - [ ] 公開可データ以外の商品が含まれていない - [ ] 点数ごとに根拠があり、推測と事実が区別されている - [ ] 小さいサンプルで結論を出していない - [ ] 非公開の実数値を本文に転記していない
03 価格シナリオの作成(price scenario)prompts/03_price_scenario.md
prompts/03_price_scenario.md
# 03 価格シナリオの作成(price scenario) ## 目的 「いくらで買えるか」を、**誰が・何点・どの特典で**買う場合の価格なのかを明示して記録する。条件を満たさない特典を単品価格に入れる誤り(例:15,000円以上の条件があるクーポンを 3,980円の商品に適用して 2,782円と表示)を防ぐ。 ## 入力 - 商品:SKU、ページ価格(1点)、在庫、日本配送、送料、税の扱い - 特典:種類、割引(定額/率・上限)、利用条件額、対象範囲、対象ユーザー、期間、併用可否と検証有無 ## 処理 1. 同じ AliExpress 商品・SKU、日本配送、JPY、アプリ/Web、アカウント条件をそろえてから、`quantity`(点数)、`ship_to: "JP"`、`eligibility`(全員/新規/会員/アプリ)を決める。API の sale_price / app_sale_price / target_sale_price だけで最終購入価格や全クーポン併用を断定しない。以下の順次割引・しきい値・端数処理は本キットの計算モデルであり、AE 全クーポン共通の仕様ではない。実際の条件と決済画面が一致しない場合は割引価格を公開せず、ページ価格+条件付き特典に戻す。 2. 適用できる特典だけを `applied_offer_ids` に**適用順**で入れる。各特典は次をすべて満たすこと: - 期間内・status=active・確認から 12 時間以内 - 対象範囲(サイト/ストア/商品)に該当 - 対象ユーザーが `eligibility` と一致(または全員) - 利用条件額 ≤ 直前までの割引後金額(ページ価格 × 点数 から順に計算) - 2 つ以上なら、互いに `stackable_with` に含まれ、`stacking_verified: true` 3. 条件を満たさない特典は `conditional_offer_ids` に入れ、価格には含めない。 4. 計算:定額は額面、率は「金額 × 率」の端数切り捨て、上限があれば上限まで。 5. `display_price` = 計算結果(`quantity` 点の合計)。`price_type` は特典ありなら `verified_discounted_price`、なしなら `page_price`。 6. 送料・税は価格に混ぜない。不明なら `null`(画面に「要確認」と出る)。 7. `node validator.js` で再計算と照合(P06〜P10, P14, P15)。 ## 出力 - `products[].scenario` の差分と、計算過程(例:`3,980円 → ストアクーポン −300円 → 3,680円`) - エンベロープ ## 受け入れ基準 - [ ] P07(しきい値未達)・P08(不一致)・P10(併用未検証)・P14(対象ユーザー不一致)が 0 件 - [ ] 表示ラベルが「ページ価格/検証済み割引後の商品価格/◯点購入時の検証済み合計」のいずれか - [ ] 複数点の場合、点数と按分方法が表示される - [ ] 送料・税を確認せずに「送料込み」「税込」と書いていない
04a クーポン速報(coupon flash)prompts/04a_coupon_flash.md
prompts/04a_coupon_flash.md
# 04a クーポン速報(coupon flash)
## 目的
「今使える特典」を素早く正確に伝え、購入直前の人のクリックと成約を取る。速報は鮮度が命なので、**期限と確認日時を必ず見せる**。
## 入力
- `publishable.json` の `offers`(必須 1 件以上)と、対象の `products`
- 任意:`campaigns`
## 処理
1. 特典ごとに「条件(いくら以上・誰が)」「割引」「期限」「コード(あれば)」を 1 行で書く。表記は `offers[].display.text_ja` と `until_ja` を使う。
2. 商品を紹介する場合は `{{product:ID}}` で埋め込み、価格は `display` の値だけを使う。条件付き特典は「条件付き」と明記。
3. しきい値がある特典は、到達の目安(例:同じストアで 2 点購入)を**事実として計算できる範囲で**示す。
4. 冒頭に「確認日時」と「期限」を置く。
5. 記事レコードを作る:`type: "coupon_flash"`、`offer_ids` 必須、`pr_disclosure: true`。
## 出力
- `articles[]` 追加分(`title_ja`、`slug`、`body_md` など)
- エンベロープ
## 受け入れ基準
- [ ] すべての特典に期限と条件が書かれている
- [ ] 期限切れ・未確認の特典を含まない(A02 が 0 件)
- [ ] 「最安値」「必ず安い」などの表現がない(A05)
- [ ] 価格は publishable の `display` と一致
- [ ] PR 表記あり04b セール攻略(sale guide)prompts/04b_sale_guide.md
prompts/04b_sale_guide.md
# 04b セール攻略(sale guide)
## 目的
大型セールの前〜期間中に「いつ・何を・どの特典で買うか」をまとめ、セール流入を成約に変える。
## 入力
- `publishable.json` の `campaigns`(必須)、関連 `offers`、`products`
- 任意:前回セールでの自分の成果(許諾範囲)
## 処理
1. 構成:①期間と開始時刻(JST)②使える特典と条件 ③しきい値の到達方法 ④カテゴリ別おすすめ(`{{product:ID}}`)⑤注意点(在庫・価格変動・送料)。
2. 開始前の特典はバリデータが除外するため、「開始後に確認して更新」と書き、推測の割引額を書かない。
3. 価格は確認時点のものと明記。セール開始後は再検証→再ビルドする。
4. 記事レコード:`type: "sale_guide"`、`campaign_id` 必須。
## 出力
- `articles[]` 追加分、更新予定(いつ再検証するか)
- エンベロープ
## 受け入れ基準
- [ ] 期間・時刻が JST で正しい
- [ ] 未開始・未確認の特典額を書いていない
- [ ] 各商品の価格ラベルと確認日時が表示される
- [ ] 更新時は `update_note_ja` に変更内容を記録04c カテゴリ定番・選び方(category evergreen)prompts/04c_category_evergreen.md
prompts/04c_category_evergreen.md
# 04c カテゴリ定番・選び方(category evergreen)
## 目的
「何を基準に選べばよいか」で検索・比較している人を、納得したうえで商品ページへ送る。長く読まれる記事なので、**価格は埋め込みカードに任せ、本文に価格を固定で書かない**。
## 入力
- `publishable.json` の同カテゴリ `products`(2 件以上推奨)
- 公開されている仕様情報(容量、重さ、サイズ、対応規格 など)
## 処理
1. 構成:①結論(用途別の選び方を 2〜3 行)②選ぶ基準(3〜5 項目)③用途別のおすすめ(`{{product:ID}}`)④比較表(仕様のみ。価格は入れない)⑤購入前の注意(配送日数・送料・保証は要確認)。
2. 仕様は根拠のある値だけ。不明な項目は「記載なし」。
3. 他社比較をする場合は `market_ref`(参考価格)の範囲のみ。比較元と確認日を書く。
4. 記事レコード:`type: "category_evergreen"`。
5. 日本の Amazon / 楽天の実例から用途比較・予算ナビ・注意点等を参考にしてよいが、他社の価格・画像・特典・帰属ルールは流用しない。実例の効果は未検証の仮説として記録し、自分のデータで検証する。
## 出力
- `articles[]` 追加分
- エンベロープ。仕様の根拠が不足していれば `draft`
## 受け入れ基準
- [ ] 本文に固定価格を書いていない(カードで表示)
- [ ] 仕様に根拠がある/不明は不明と書いている
- [ ] 最上級表現なし、PR 表記あり04d 実購入レビュー(honest review)prompts/04d_honest_review.md
prompts/04d_honest_review.md
# 04d 実購入レビュー(honest review)
## 目的
実際に買って使った体験で、購入をためらう理由(品質・届くまでの日数・サイズ感)を解消する。
## 入力
- 購入記録(`purchase_record`:購入日時と根拠 ID)— **必須**
- 自分で撮影した写真(`image.rights: "own_photo"`)、使用期間、使用条件
- `publishable.json` の該当商品
## 処理
1. 構成:①結論(向いている人/向いていない人)②購入情報(購入日・注文から到着までの日数・購入時の価格は「購入時点」と明記)③良かった点 ④気になった点(必ず書く)⑤現在の価格(`{{product:ID}}`)。
2. 体験していないことは書かない。メーカー説明は「メーカー記載」と区別する。
3. 提供品の場合はその旨を明記し、実購入と呼ばない。購入記録がない提供品はこの実購入型ではなく、category_evergreen 等で提供・実測条件を開示する。参考ケースの作者の購入申告を自分の purchase_record に転記しない。
4. 記事レコード:`type: "honest_review"`、`purchase_record` 必須。
## 出力
- `articles[]` 追加分
- エンベロープ。購入記録がなければ `block`(A03)
## 受け入れ基準
- [ ] 購入記録と根拠がある
- [ ] 気になった点が書かれている
- [ ] 購入時価格と現在価格が区別されている
- [ ] PR 表記(提供品なら提供の旨も)あり04e はじめての AliExpress ガイド(beginner guide)prompts/04e_beginner_guide.md
prompts/04e_beginner_guide.md
# 04e はじめての AliExpress ガイド(beginner guide)
## 目的
初めての人の不安(届くまでの日数、送料・関税、支払い、返品、クーポンの使い方)を解消し、初回購入につなげる。
## 入力
- AliExpress の公開ヘルプ・規約ページ(URL と確認日)
- 任意:`publishable.json` の初心者向け商品・新規ユーザー向け特典
## 処理
1. 構成:①3 分でわかる流れ ②届くまでの目安と確認方法 ③送料・税・手数料(商品ページで要確認)④支払い方法 ⑤返品・返金の窓口 ⑥クーポンの使い方(条件・対象ユーザー・期限の見方)⑦初めてにおすすめの商品(`{{product:ID}}`)。
2. 制度・手数料・日数は公開情報の範囲で、確認日を書く。断定できないものは「商品ページで確認」と案内。
3. 新規ユーザー向け特典は「新規ユーザー限定」と明記(価格シナリオの `eligibility: "new_user"`)。
4. 記事レコード:`type: "beginner_guide"`。制度変更時は更新し `update_note_ja` を記録。
## 出力
- `articles[]` 追加分、参照した公開ページの一覧
- エンベロープ
## 受け入れ基準
- [ ] 制度・日数・手数料に出典と確認日がある
- [ ] 「必ず届く」「関税はかからない」などの断定がない
- [ ] 対象ユーザー限定の特典に対象が明記されている05 配信と拡散(distribution)prompts/05_distribution.md
prompts/05_distribution.md
# 05 配信と拡散(distribution) ## 目的 サイト外(X / Instagram / Threads / LINE / YouTube / TikTok など)で、新しい層に届け、サイトや商品ページへの有効な流入を増やす。 ## 入力 - `publishable.json` の `products` / `offers` / `articles` - `channels`(チャネルごとの計測方法:ポータルで発行した sub ID など) - 任意:チャネル別の過去成果(許諾範囲) ## 処理 1. チャネルごとに形式を変える: | チャネル | 形式の例 | |---|---| | X / Threads | 1 投稿 1 特典。条件・期限・確認時刻を 1 行で | | Instagram | カルーセル:結論 → 価格(ラベル付き)→ 条件付き特典 → 注意点 | | LINE | 週 1 回のまとめ。期限が近い順 | | YouTube / TikTok | 開封・使用シーン。価格は概要欄にラベルと確認日時付き | 2. すべての投稿に PR 表記(例:`#PR`、「広告を含みます」)を入れる。 3. 公式生成リンクを使用する。通常は無加工。開通・設定済み S2S のみ af / cn / cv / dp の公式透伝を使用でき、af はサブアフィリエイト登録が必要。元リンクを `link_policy.original_url` に保存し、公開用の dp にメール・ユーザー ID など個人情報を入れない。チャネルは `tracking_method: "s2s"` または公式ツールの実際の設定を記録する。接続テスト・遷移成功・支払通知・精算完了を区別する。 4. 価格・期限は投稿時点の `display` 値のみ。投稿後に期限切れになった場合の対応(削除・追記)を決めておく。 5. 破圈(新しい層への拡散)のための切り口:用途別(通勤・キャンプ・推し活 など)、悩み別、季節行事別。根拠のない話題化(誇張・煽り)はしない。 ## 出力 - チャネル別の投稿案(本文、ハッシュタグ、使用リンクの識別名、投稿推奨時刻、期限切れ時の対応) - エンベロープ ## 受け入れ基準 - [ ] 全投稿に PR 表記 - [ ] 価格にラベルと確認日時 - [ ] 公式原本を保存し、通常は無加工、S2S は許可された追記のみ。計測方法が `channels` に記録済み - [ ] 期限切れ時の対応が決まっている
06 週次レビュー(weekly review)prompts/06_weekly_review.md
prompts/06_weekly_review.md
# 06 週次レビュー(weekly review) ## 目的 成果データで「どこが詰まっているか」を見つけ、次の 1 週間の改善を 1〜3 個に絞る。 ## 入力 - 自分のアカウントの成果(許諾範囲):ページ/投稿別の訪問、アフィリエイト出口クリック、注文、売上、キャンセル・返金 - 計測定義:重複の扱い、帰属期間、キャンセル・返金の扱い、反映の遅れ(何日前までを確定とみなすか) - 前週に実施した変更の記録 ## 処理 1. **定義をそろえる**。前週と定義が違う場合は比較しない。反映の遅れがある直近日は除外する。 - AliExpress API の支払ベース分析は PaymentCompletedTime と対象状態、精算済み報酬は CompletedSettlementTime + CompletedSettlement を区別する。現在の仕様・権限で確認し、未精算を精算済みと呼ばない。 - S2S の order_id は子注文。effect_pay_time は米国太平洋時間の処理時刻で、実際の支払時刻とずれる場合がある。America/Los_Angeles で夏時間を扱う。commission_fee は支払時点の見込報酬。 - order_amount は USD、dollars / cents は受信設定で確認。local_order_amout(原フィールドの綴り)と currency を分けて保存する。exchange_rate の 0 / 1 を実際の為替レートと解釈しない。 - 自分の許諾されたデータだけを私的に分析する。内部レポート、他のパートナーの数値、社内システムの照会手順を出力しない。 2. 分解:GMV = 訪問数 × 出口クリック率 × クリック後の成約率 × 平均注文額。 3. 詰まりの候補を**複数**挙げる(一つの原因と決めつけない): | 症状 | 考えられる原因(例) | 次に確認すること | |---|---|---| | 訪問が少ない | 需要とずれた題材、検索意図と不一致、配信不足 | 流入元別の内訳、題材の季節性 | | クリック率が低い | 価格・特典が伝わらない、CTA の位置、期待とずれた商品 | 価格ラベルの表示位置、記事内の位置別クリック | | 成約率が低い | 在庫・価格の変化、条件付き特典の誤解、送料・配送日数、商品とのミスマッチ、計測遅れ | 確認日時からの経過、商品ページとの差、反映遅延 | | 注文額が低い | しきい値の案内不足、関連商品の不足 | しきい値到達の提案有無 | 4. サンプルが小さい場合(目安:クリック 100 未満、注文 10 未満)は**判断を保留**し、観察を続ける。少数成果だけで掲載停止などを判断しない。ただし誤価格・在庫不明など公開ゲート上の停止はサンプル数に関係なく行う。この閾値はキットの目安で、AE 規則や統計的有意差の保証ではない。 5. 改善案は「仮説・変更内容・見る指標・期間・判定基準」で書く(`loop` の実験テンプレート)。 ## 出力 - 今週のまとめ(定義、分解結果、詰まり候補と根拠、保留事項) - 次週の実験 1〜3 件 - エンベロープ。非公開の数値は社外向け文章に転記しない ## 受け入れ基準 - [ ] 定義がそろっている/そろわない比較をしていない - [ ] 原因を一つに決めつけていない - [ ] 小さいサンプルで結論を出していない - [ ] 実験に判定基準と期間がある
07 新規サイトの構築(static site)prompts/07_static_site.md
prompts/07_static_site.md
# 07 新規サイトの構築(static site) ## 目的 `starter/` をもとに、自分のサイトとして公開できる状態にする。**サイトはデータを表示する器**であり、公開判断はバリデータが行う。 ## 入力 - `starter/`(index.html, app.js, ae-render.js, style.css) - `starter/data/publishable.js`(`node validator.js data --mode production --out starter/data/publishable.js --strict` で生成) - サイト名、テーマ(カテゴリ・読者)、デザインの希望 ## 処理 1. サイト名・説明・配色を変更。PR 表記(ヘッダーと記事)と「このサイトについて」は残す。 2. ページ構成の例:トップ(キャンペーン → 特典 → 商品 → 新着記事)、記事一覧、記事、カテゴリ別一覧、このサイトについて。 3. 商品・特典の表示は `ae-render.js` の関数(`productCard`、`offerItem`)を使い、価格・ラベル・確認日時・条件付き特典・送料表示を削らない。 4. 期限切れの自動非表示(`display.hide_after`)を外さない。 5. 必要なら静的ページ生成(記事ごとの HTML)に拡張してよいが、データは publishable のみを使う。 6. 構造化データを入れる場合も、検索結果での表示や順位の向上を前提にしない。 7. 静的ホスティング(Cloudflare Pages、GitHub Pages、Netlify など)への公開手順を示し、外部公開の確認を得てから `starter/` を公開。データ更新のたびに validator → 再デプロイ。 8. API 認証・署名・S2S 受信は公開 JavaScript に入れない。静的表示だけで実 API や通知が接続済みと説明しない。商品情報は AE の現在資格・同じ SKU・日本配送を通過したもののみ。 ## 出力 - 変更したファイル一覧と差分 - 公開手順(ビルド・デプロイのコマンド) - エンベロープ ## 受け入れ基準 - [ ] `publishable.js` 以外のデータを読んでいない - [ ] 価格ラベル・確認日時・送料表示・条件付き特典・PR 表記が全カードにある - [ ] `hide_after` による非表示が動く(`--now` を未来にして確認) - [ ] リンクに `rel="sponsored"` が付き、URL が無加工 - [ ] スマートフォン幅で崩れない
08 既存サイトへの組み込み(existing site)prompts/08_existing_site.md
prompts/08_existing_site.md
# 08 既存サイトへの組み込み(existing site) ## 目的 すでに運営しているブログ・比較サイト・まとめサイトに、検証済みの商品カードと特典一覧を差し込み、既存の流入を成約につなげる。 ## 入力 - 既存サイトの仕組み(WordPress、はてなブログ、静的サイト、独自 CMS など) - `publishable.js`、`ae-render.js`、`style.css` - 差し込みたい記事と商品 ID ## 処理 1. 3 ファイルをサイトの静的ファイル置き場(例 `/ae/`)にアップロード。 2. 記事に貼る: ```html <link rel="stylesheet" href="/ae/style.css"> <div data-ae-product="PR-A"></div> <div data-ae-offers></div> <script src="/ae/publishable.js"></script> <script src="/ae/ae-render.js"></script> ``` 3. 既存サイトの CSS と衝突する場合は `.ae-` で始まるクラスだけを調整。表示項目(価格ラベル、確認日時、送料、条件付き特典、PR 表記)は削らない。 4. 既存記事に本文で固定価格を書いている場合は、カード表示に置き換えるか「◯月◯日時点」と明記。 5. 外部スクリプトを使えない CMS では、validator の出力(`display`)から静的 HTML を生成して貼る。この場合は更新時に貼り直しが必要なことを `human_review` に書く。 6. データ更新の流れ:供給パック更新 → validator → `publishable.js` を上書きアップロード。 ## 出力 - 対象 CMS 向けの手順と貼り付けコード - 置き換えた記事の一覧 - エンベロープ ## 受け入れ基準 - [ ] カードが表示され、期限切れは自動で消える - [ ] 既存記事の PR 表記がある - [ ] 固定価格の記述が残っていない、または時点が明記されている - [ ] リンクが無加工