thth 5.6.2__tar.gz → 5.6.3__tar.gz

{thth-5.6.2 → thth-5.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 5.6.2
+Version: 5.6.3
 Summary: 承認済みの投稿だけを投げる門（Threads・Bluesky・Mastodon）。人が承認し、記録は利用者の git に残る。
 Project-URL: Homepage, https://thth.me
 Project-URL: Source, https://github.com/aokings/thth
@@ -43,6 +43,7 @@ English: [README.en.md](README.en.md) · サイト: https://thth.me · 文書の
 
 - **調べる**: `thth topics <アカウント> --search <語>` で、その語の件数・投稿者の数・最新の投稿を見ます。`thth where` は「次にどこで話すか」を、自分がすでに絡んだ相手を重ねて探します。X の行には投稿者のフォロワー数（「フォロワー 1.2 万」）と投稿数も付きます（`--json` は `author_followers`・`author_posts`。保存しません）。
 - **出す**: `thth send` で今すぐ、`thth schedule` で予約、`--reply-to` で返信です。
+- **広告の成績と手順の skill**（5.6.3・下書き）: `thth ads insights` が反応の内訳（いいね・リアクション／コメント／シェア／写真を開いた／ページへのいいね）・サイトへの誘導（リンククリック・サイトへ出たクリック・頁が開いた）・1 件あたりの額・効率（frequency・cpm・ctr・cpc ほか Meta の計算済みの値）・動画の見られた深さを出します。`clicks` はリンクのクリックではありません。数が 0 か、計測が無くて分からないかを分けて書きます（`site.why`）。`--by age-gender|region|country|placement|device|hour` で内訳、`thth ads estimate` で出す前の見積もり、`thth ads doctor`・`show` でピクセルの有無と最後に動いた時刻を読みます（読むだけ）。`thth ads boost --utm-campaign <原稿のファイル名>` でリンクに有機の投稿と同じ campaign の UTM（`utm_medium=paid`）を付けます。広告を出す LLM 向けの手順は skill `thth-ads`（`skills/thth-ads/`・`thth ads skill --print`）で、広告の命令の次の一手（`next_steps`）とエラーの文は先頭でそれを示します（[リリースノート 5.6.3（下書き）](docs/リリースノート_5.6.3_2026-11-03.md)）。
 - **Meta の広告**（5.6.2）: `thth ads boost` は全部 PAUSED で作り、始めるのは `thth ads activate` の 2 段だけです。`thth ads watch` は成績を読み続け、指定の額か表示数に達したら `thth ads stop` と同じに止めます（`--until` で必ず終わる）。`spend_cap`・月の上限・旗を上げる命令はありません。例外は 1 つで、止めた印を外す `thth ads resume` は 2 段＋hub の承認の番号が必須です（masaru 11/02・外すのは印だけで、広告は PAUSED のまま）（[リリースノート 5.6.2](docs/リリースノート_5.6.2_2026-11-02.md)）。
 - **ブックマークの連投は記事と別に数える**（4.0.1）: はてなブックマークは主体の別の窓（既定 10 分に 10 件）で数え、超えても主体を止めずにその 1 件だけ断ります。1 日 30 件・同じホストへ 1 日 3 件（自分の記事は 1 日 1 件のまま）。記事の連投で止める作りは変わりません（[リリースノート 4.0.1](docs/リリースノート_4.0.1_2026-10-17.md)）。
 - **X の全期間の検索**（4.5.0）: `thth archive <口座> --from <handle> --title <曲名> [--max-total 20] [--json]` で 2006 年からの他人の公開投稿を読みます（id・URL・時刻・本文・handle・保存しない）。`--count-only` は件数だけ（1 回 0.010 USD）。返った本数で月の X 予算に数え、1 日の本数は `x_archive_daily_reads`（既定 0＝読まない）で別に縛ります。timer からは叩きません（[リリースノート 4.5.0](docs/リリースノート_4.5.0_2026-10-21.md)）。
@@ -97,7 +98,7 @@ thth send <アカウント> --text "こんにちは"
 claude mcp add thth -- thth-mcp
 ```
 
-MCP の道具は CLI の写しで、同じ `thth` コマンドを呼ぶだけです。スキル（`skills/thth/`）は「投稿する前に何を見るか」「返信をどう扱うか」をアシスタントに教えます。キーはアシスタントに渡しません。`thth login` が手元に置いたキーを `thth` コマンドが使います。
+MCP の道具は CLI の写しで、同じ `thth` コマンドを呼ぶだけです。スキル（`skills/thth/`）は「投稿する前に何を見るか」「返信をどう扱うか」をアシスタントに教えます。記事を軸に告知・セルクマ・広告までつなぐ流れと、印（UTM）・測り方は `skills/thth-flow/` が教えます。広告を出すときの手順は別のスキル（`skills/thth-ads/`・pip で入れた場合は `thth ads skill` が場所を出します）です。キーはアシスタントに渡しません。`thth login` が手元に置いたキーを `thth` コマンドが使います。
 
 ## ガード
 

{thth-5.6.2 → thth-5.6.3}/README.md

@@ -19,6 +19,7 @@ English: [README.en.md](README.en.md) · サイト: https://thth.me · 文書の
 
 - **調べる**: `thth topics <アカウント> --search <語>` で、その語の件数・投稿者の数・最新の投稿を見ます。`thth where` は「次にどこで話すか」を、自分がすでに絡んだ相手を重ねて探します。X の行には投稿者のフォロワー数（「フォロワー 1.2 万」）と投稿数も付きます（`--json` は `author_followers`・`author_posts`。保存しません）。
 - **出す**: `thth send` で今すぐ、`thth schedule` で予約、`--reply-to` で返信です。
+- **広告の成績と手順の skill**（5.6.3・下書き）: `thth ads insights` が反応の内訳（いいね・リアクション／コメント／シェア／写真を開いた／ページへのいいね）・サイトへの誘導（リンククリック・サイトへ出たクリック・頁が開いた）・1 件あたりの額・効率（frequency・cpm・ctr・cpc ほか Meta の計算済みの値）・動画の見られた深さを出します。`clicks` はリンクのクリックではありません。数が 0 か、計測が無くて分からないかを分けて書きます（`site.why`）。`--by age-gender|region|country|placement|device|hour` で内訳、`thth ads estimate` で出す前の見積もり、`thth ads doctor`・`show` でピクセルの有無と最後に動いた時刻を読みます（読むだけ）。`thth ads boost --utm-campaign <原稿のファイル名>` でリンクに有機の投稿と同じ campaign の UTM（`utm_medium=paid`）を付けます。広告を出す LLM 向けの手順は skill `thth-ads`（`skills/thth-ads/`・`thth ads skill --print`）で、広告の命令の次の一手（`next_steps`）とエラーの文は先頭でそれを示します（[リリースノート 5.6.3（下書き）](docs/リリースノート_5.6.3_2026-11-03.md)）。
 - **Meta の広告**（5.6.2）: `thth ads boost` は全部 PAUSED で作り、始めるのは `thth ads activate` の 2 段だけです。`thth ads watch` は成績を読み続け、指定の額か表示数に達したら `thth ads stop` と同じに止めます（`--until` で必ず終わる）。`spend_cap`・月の上限・旗を上げる命令はありません。例外は 1 つで、止めた印を外す `thth ads resume` は 2 段＋hub の承認の番号が必須です（masaru 11/02・外すのは印だけで、広告は PAUSED のまま）（[リリースノート 5.6.2](docs/リリースノート_5.6.2_2026-11-02.md)）。
 - **ブックマークの連投は記事と別に数える**（4.0.1）: はてなブックマークは主体の別の窓（既定 10 分に 10 件）で数え、超えても主体を止めずにその 1 件だけ断ります。1 日 30 件・同じホストへ 1 日 3 件（自分の記事は 1 日 1 件のまま）。記事の連投で止める作りは変わりません（[リリースノート 4.0.1](docs/リリースノート_4.0.1_2026-10-17.md)）。
 - **X の全期間の検索**（4.5.0）: `thth archive <口座> --from <handle> --title <曲名> [--max-total 20] [--json]` で 2006 年からの他人の公開投稿を読みます（id・URL・時刻・本文・handle・保存しない）。`--count-only` は件数だけ（1 回 0.010 USD）。返った本数で月の X 予算に数え、1 日の本数は `x_archive_daily_reads`（既定 0＝読まない）で別に縛ります。timer からは叩きません（[リリースノート 4.5.0](docs/リリースノート_4.5.0_2026-10-21.md)）。
@@ -73,7 +74,7 @@ thth send <アカウント> --text "こんにちは"
 claude mcp add thth -- thth-mcp
 ```
 
-MCP の道具は CLI の写しで、同じ `thth` コマンドを呼ぶだけです。スキル（`skills/thth/`）は「投稿する前に何を見るか」「返信をどう扱うか」をアシスタントに教えます。キーはアシスタントに渡しません。`thth login` が手元に置いたキーを `thth` コマンドが使います。
+MCP の道具は CLI の写しで、同じ `thth` コマンドを呼ぶだけです。スキル（`skills/thth/`）は「投稿する前に何を見るか」「返信をどう扱うか」をアシスタントに教えます。記事を軸に告知・セルクマ・広告までつなぐ流れと、印（UTM）・測り方は `skills/thth-flow/` が教えます。広告を出すときの手順は別のスキル（`skills/thth-ads/`・pip で入れた場合は `thth ads skill` が場所を出します）です。キーはアシスタントに渡しません。`thth login` が手元に置いたキーを `thth` コマンドが使います。
 
 ## ガード
 

{thth-5.6.2 → thth-5.6.3}/mcp/server.py

@@ -561,19 +561,26 @@ TOOLS += [
 # 広告（Meta 計画 段 5 の 7）。**出すのは show・boost（PAUSED まで）・pause・stop だけ。** 配信を始める
 # `activate`・延ばす `extend`・予算を下げる・終了日を早めるは MCP に出さない（始める・延ばすは CLI で masaru か
 # 運用が 2 段で押す）。`spend_cap`・月の上限・`ads_enabled` を上げる道具はどこにも無い（D-1）。
+# 5.6.3（masaru 11/03「読めとかやれとか言う前に skills を提示するべき」）: 広告の道具の説明は、まず skill を示す。
+ADS_SKILL = ("まず広告の手順の skill thth-ads を読む（CLI `thth ads skill --print` で全文・repo の skills/thth-ads/SKILL.md・"
+             "pip では thth/skills/thth-ads/SKILL.md）。返る json の next_steps は先頭が skill、そのあとが個別の一手。")
+ADS_PIXEL_FLOW = ("サイトへの誘導（objective traffic）は返る next_steps を上から読む: ピクセルが無ければイベントマネージャで作って"
+                  "もらう・動いていなければ誘導先のサイトの repo にピクセルの基本のコードを入れ、thth ads doctor で動いたかを見る"
+                  "（THTH はピクセルを作らない・サイトに触らない）。")
 ADS_NOTE = ("金額は最小単位の整数（JPY なら円）。お金が動くのは配信を始めたときだけで、始める（activate）・延ばす（extend）は "
             "MCP に無い（CLI で人が 2 段で押す）。spend_cap・上限を上げる道具も無い")
 ADS_TOOLS = [
     {"name": "thth_ads_show",
-     "description": ("広告の口座を読む（thth ads show --json と同じ形・読むだけ）。spend_cap・amount_spent・動いている物・"
-                     "要対応（THTH の外で始まった配信・止めたと確かめられない ほか）。" + ADS_NOTE),
+     "description": (ADS_SKILL + "広告の口座を読む（thth ads show --json と同じ形・読むだけ）。spend_cap・amount_spent・"
+                     "動いている物・ピクセル（pixels・pixel_ready）・要対応（THTH の外で始まった配信・止めたと確かめられない ほか）。"
+                     + ADS_PIXEL_FLOW + ADS_NOTE),
      "inputSchema": {"type": "object", "properties": {
          "adaccount": {"type": "string", "description": "広告の口座の名前（例 kopicha-ads）"}},
          "required": ["adaccount"], "additionalProperties": False}},
     {"name": "thth_ads_boost",
-     "description": ("ページの投稿を広告にする下書きを作る（キャンペーン・広告セット・クリエイティブ・広告を全部 PAUSED で作る・"
+     "description": (ADS_SKILL + "ページの投稿を広告にする下書きを作る（キャンペーン・広告セット・クリエイティブ・広告を全部 PAUSED で作る・"
                      "お金は動かない）。終了日は必須。1 操作の上限（通しの予算・期間）を超える指定は作らない。"
-                     "始めるのは人が CLI で thth ads activate を 2 段で押す。" + ADS_NOTE),
+                     "始めるのは人が CLI で thth ads activate を 2 段で押す。" + ADS_PIXEL_FLOW + ADS_NOTE),
      "inputSchema": {"type": "object", "properties": {
          "adaccount": {"type": "string", "description": "広告の口座の名前"},
          "post": {"type": "string", "description": "THTH で出したページの投稿の post_id（object_story_id とどちらか）"},
@@ -582,10 +589,18 @@ ADS_TOOLS = [
          "start": {"type": "string", "description": "開始（ISO 8601 か now・既定 now）"},
          "end": {"type": "string", "description": "終了（必須・ISO 8601）"},
          "platforms": {"type": "string", "description": "facebook か facebook,instagram（既定 facebook）"},
+         "objective": {"type": "string", "enum": ["engagement", "traffic", "reach"],
+                       "description": "目的（既定 engagement。traffic＝サイトへの誘導・reach＝認知）"},
+         "url_tags": {"type": "string",
+                      "description": "リンクに付ける印（クリエイティブの url_tags・例 utm_source=facebook&utm_medium=paid）"},
+         "utm_campaign": {"type": "string",
+                          "description": "元の投稿の原稿のファイル名（拡張子なし）。url_tags が無ければ "
+                                         "utm_source=<出し先>&utm_medium=paid&utm_campaign=<これ> を付ける"},
+         "landing_url": {"type": "string", "description": "誘導先の頁の URL（次の一手の文に入る・Meta には送らない）"},
          "by": {"type": "string", "description": "打った人の名前（記録に残る）"}},
          "required": ["adaccount", "lifetime", "end", "by"], "additionalProperties": False}},
     {"name": "thth_ads_pause",
-     "description": ("広告を止める（status=PAUSED・承認なし・止めた口座でも通す・量の制限で待たない）。all か ids のどちらか。"
+     "description": (ADS_SKILL + "広告を止める（status=PAUSED・承認なし・止めた口座でも通す・量の制限で待たない）。all か ids のどちらか。"
                      "失敗した物があれば管理画面で止める"),
      "inputSchema": {"type": "object", "properties": {
          "adaccount": {"type": "string", "description": "広告の口座の名前"},
@@ -594,7 +609,7 @@ ADS_TOOLS = [
          "by": {"type": "string", "description": "打った人の名前"}},
          "required": ["adaccount", "by"], "additionalProperties": False}},
     {"name": "thth_ads_stop",
-     "description": ("広告の口座を止める: 全部 PAUSED → THTH の止め → Meta から読み直して確かめる（処理中なら最大 30 秒待つ）"
+     "description": (ADS_SKILL + "広告の口座を止める: 全部 PAUSED → THTH の止め → Meta から読み直して確かめる（処理中なら最大 30 秒待つ）"
                      " → spend_cap を使った額＋少しの余白まで下げる。"
                      "「止まった」と言うのは読み直しで確かめたときだけ。言えなければ hub に送る 1 行（waiting_on_masaru）を返すので、"
                      "そのまま hub に送り、管理画面で止めてもらう"),
@@ -604,6 +619,9 @@ ADS_TOOLS = [
          "required": ["adaccount", "by"], "additionalProperties": False}},
 ]
 TOOLS += ADS_TOOLS
+# MCP の instructions（initialize で返す）。広告は、まず skill を示す（5.6.3）。
+MCP_INSTRUCTIONS = ("THTH は承認済みの投稿だけを投げる門。広告（thth_ads_*）を使う前に、" + ADS_SKILL
+                    + "お金が動く始める・延ばすは MCP に無い（人が CLI で 2 段で押す）。")
 
 
 class ToolInputError(Exception):
@@ -1880,6 +1898,10 @@ def call_tool(name: str, arguments: dict | None) -> dict:
         args = ["ads", "boost", arguments["adaccount"], *target, "--lifetime", str(arguments["lifetime"]),
                 "--start", arguments.get("start") or "now", "--end", arguments["end"],
                 "--platforms", arguments.get("platforms") or "facebook",
+                "--objective", arguments.get("objective") or "engagement",
+                *(["--url-tags", arguments["url_tags"]] if arguments.get("url_tags") else []),
+                *(["--landing-url", arguments["landing_url"]] if arguments.get("landing_url") else []),
+                *(["--utm-campaign", arguments["utm_campaign"]] if arguments.get("utm_campaign") else []),
                 "--by", arguments["by"], "--via", "mcp", "--json"]
         proc = run_cli(args)
         text = proc.stdout
@@ -1971,6 +1993,7 @@ def _handle_request(req: dict):
                 "protocolVersion": "2024-11-05",
                 "capabilities": {"tools": {}},
                 "serverInfo": {"name": "thth", "version": "0.1.0"},
+                "instructions": MCP_INSTRUCTIONS,
             },
         }
     if method == "notifications/initialized":

{thth-5.6.2 → thth-5.6.3}/skills/thth/SKILL.md

@@ -7,6 +7,8 @@ description: 投稿する前・返信を書く前・出したあと・絡みに
 
 **新しいセッションは最初に生きたコツ集を読む**（3.8.0）: `thth_plaza_digest`（CLI は `thth plaza digest <project>`・読むだけ）。2 SNS以上で再現した施策・気づきが、再現しなかったSNSと試していないSNSも並んで（分母つき）出る（道具が付けた観測がある施策だけは置いたSNSも 1 と数え、各行に「数え方」が出る）。
 
+**流れ全体（調べる→はてブ→はてなブログ→本体の記事→告知とセルクマ→広告）と印（UTM）・測り方は skill `thth-flow`（`skills/thth-flow/SKILL.md`）を先に見る。**
+
 **出来事と数だけを機械に読ませるときは `thth_events`・`thth_summary`**（4.0 の柱 1・読むだけ・媒体は呼ばない）。`thth events <project|account> --since 24h --json` は公開・取り下げ・届いた返信と言及・止まった口座・公開の結果待ち・予算切れ・予約の在庫切れの前触れ（`schedule_low`＝最後の予約が 48 時間より手前・`schedule_thin`＝1 日の本数が直近 7 日の平均の 6 割を切る日がある）を時刻順に（各行 `{schema: "thth.events/1", kind, account, occurred_at, recorded_at, ref, summary, event_id}`・他人の本文は入らない。続きは答えの `next_cursor` を `--after` に渡して読み、同じ出来事が 2 度来たら `event_id` で除く）、`thth summary <project|account> --json` は 24h・7d の公開数と反応の和・返していない返信・フォロワーの前日差・止まりを返す。`observe --json` の節は `sections_by_name.<名前>` で引く（`schema: "thth.observe/1"`。並びの `sections` は 4.0 で外す）。
 
 **断られたら・違和感があれば報告の口へ**: `thth_report_file`（CLI は `thth report file <account> --kind bug|request|friction --title … --body-file … --by <名前>`）。つまずき・迷い・期待との違いの報告は、利用者の作業の一部として歓迎します。小さいものも。重複は道具が束ねます。例: 「止まったのに気づかなかった」「断られた理由が分からなかった」「同じ操作を 3 回繰り返した」。道具が断った・結果が期待と違った・欲しい形がある・迷った（`friction`）、のどれかなら 1 回で置ける。**断られた直後なら、断りの最後の `report_channel:` の行をそのまま打てばよい**（`--from-last-refusal` が、道具が控えた直前の断り——時刻・版・コマンド・理由の符丁だけで、本文と引数の値は控えていない——を再現手順に添える。MCP は `thth_report_file {"account": …, "title": …, "from_last_refusal": true}`）。置いた報告がこの版で閉じたかは `thth_observe` の 0 段 `project_reports` に出る。返事は `thth_report_show` と `handoff-report --since-last-read` の `tool.reports` に出る。秘密らしき値が含まれていたら置かれない（伏せてから置き直す）。
@@ -77,7 +79,7 @@ THTH は CLI ツール。あなた（エージェント）が使う MCP の道
 ## キャンペーンとシリーズ（scenario・5.0 段 1）
 
 抜け・漏れ・忘れを 1 枚で見るための宣言。**THTH は読んで数えるだけ**（原稿を書かない・段を進めない・予約を置かない）。宣言は窓口が原稿の隣に書く: `docs/sns/scenarios/<id>.md`（queue の 1 つ上の `scenarios/`）。
-- キャンペーン（糸）: front-matter に `thth_scenario: 1`・`kind: thread`・`id`（小文字・数字・`-`・`_`、ファイル名と同じ）・`title`・任意で `goal_text`（60 字まで）・`stale_after_days`（既定 7）・`started`（日付）。本文に段を上から順に 1 行ずつ `- <段>: <媒体> <条件>`（媒体は `hatena_bookmark`・`hatenablog`・`site`・`threads`・`x`・`bluesky`・`mastodon`・`facebook`、SNS は `threads,x` と並べられる。条件は `need=<本数>`・`tag=<タグ>`（はてブ・既定は id）・`signal=<出来事>`（site・既定 `article_published`）・`replies_within_hours=<時間>`（`warm`））。出来事は `- 2026-10-27 article_published <短い文>`（`researched`・`hypothesis`・`article_published`・`closed` など。`researched` は collect、`hypothesis` は diary の本数の代わりになる。`closed` で終わり）。
+- キャンペーン（糸）: front-matter に `thth_scenario: 1`・`kind: thread`・`id`（小文字・数字・`-`・`_`、ファイル名と同じ）・`title`・任意で `goal_text`（60 字まで）・`stale_after_days`（既定 7）・`started`（日付）。本文に段を上から順に 1 行ずつ `- <段>: <媒体> <条件>`（媒体は `hatena_bookmark`・`hatenablog`・`site`・`threads`・`x`・`bluesky`・`mastodon`・`facebook`・`instagram`、SNS は `threads,x` と並べられる。条件は `need=<本数>`・`tag=<タグ>`（はてブ・既定は id）・`signal=<出来事>`（site・既定 `article_published`）・`replies_within_hours=<時間>`（`warm`））。出来事は `- 2026-10-27 article_published <短い文>`（`researched`・`hypothesis`・`article_published`・`closed` など。`researched` は collect、`hypothesis` は diary の本数の代わりになる。`closed` で終わり）。
 - シリーズ（型）: `kind: series`・`accounts: a, b`・`slots: tue 07:00, fri 07:00`（曜日を省けば毎日）・`stock_floor`（既定 2）・任意で `material_remaining`・`material_written_at`（窓口が書く数と日付）。期日の型は `deadline: true`（原稿の `not_after` を数える）。
 - 原稿の札: front-matter に `thread: <id>`・`series: <id>`。**承認の指紋に入らない**（付け足しても直しても再承認は要らない）。宣言が無い id は lint が `thread_not_declared`／`series_not_declared` の予告を出すだけ（断らない）。はてブはタグで結ぶ（札は書かない）。
 - 命令: `thth scenario <project|account> [--json]`（一覧・`schema: "thth.scenario/1"`）・`thth scenario show <project> <id> [--json]`（段ごとの原稿の名前と状態・出来事。キャンペーンは `stages[].items`（段ごとの成果物）、シリーズは `slots_upcoming`（今後 4 週の枠）、両方に `items[].delivery`・`post_ids` と `deliveries`）・`thth scenario lint <project> [--json]`（宣言の誤り・無い id を指す札・未分類の原稿）。`next` は名詞（「x に 1 本（announce）」「article_published を糸のファイルに 1 行」）で、本文は入らない。読めない台帳は `cannot_say`（0 と混ぜない）。
@@ -122,15 +124,11 @@ THTH は CLI ツール。あなた（エージェント）が使う MCP の道
 - **文字数の上限 2,200**（キャプションの公式の上限）。ハッシュタグ 30・@ 20 は媒体が数える。
 - **90 日ごとに `thth auth` をやり直す**: instagram の権限はデータに触れる期限（`data_access_expires_at`）に当たる見込み。14 日を切ると `thth maintain` が `data_access_expiring` と言う。
 
-## 広告（Meta 計画 段 4〜5・10/31）
+## 広告（Meta 計画 段 4〜5・10/31〜）
 
-- 広告は投稿先の媒体ではないので `thth account` でなく `thth ads`。台帳は VM の `adaccounts/<名前>.json`（上限 `ceilings` は 0・`ads_enabled`／`production` は false が既定）、状態は `adaccount_state/<名前>/`。金額は**最小単位の整数**（JPY なら円）。
-- **上げる命令は無い**: `spend_cap` を上げる・外すのは masaru が広告マネージャで。月の上限・1 操作の上限（`lifetime_budget_max`・`days_max`）・`ads_enabled`・`production` を上げるのは VM の台帳を `cp -a` で控えてから直接書く。止めた口座を戻すのも VM（`adaccount_state/<名前>/guard/stopped.json` を控えてから消す）。この「上げられない・戻せない」は、VM の鍵と台帳を読める人以外に対しての柵（MCP からは越えられない）。
-- 読む: `thth ads add|auth|show|insights|doctor|accounts|collect`（段 4）。鍵が期限なし（`expires_at=0`）なら「期限なし」と言い、残り 14 日の柵はデータに触れる期限（`data_access_expires_at`）で効く。`thth ads doctor` は `/debug_token` の今の値で `.token` の期限の欄を書き直す。
-- 作る（お金は動かない）: `thth ads boost <名前> --post <post_id>|--object-story-id <ページID>_<数字> --lifetime <額> --end <時刻> [--start now] [--platforms facebook,instagram] --by <名前>`。キャンペーン・広告セット・クリエイティブ・広告を**全部 `PAUSED`** で作る。終了日は必須・1 操作の上限を超える指定は作らない。MCP の `thth_ads_boost` も同じ。
-- **始める（お金が動く・CLI だけ）**: `thth ads activate <名前> <campaign_id> --by <名前>` が digest と木（予算・期間・広告）を出す → 人が見て hub で承認 → `--confirm <digest> --approval <hub の番号>` で 2 段目。2 段目で Meta から木を読み直し、変わっていれば `ads_tree_changed` で断る。月の上限の予約・`spend_cap` が入っていること・鍵の残り 14 日以上・`ads_enabled`・`production` が要る。延ばす・増やすは `thth ads extend`（同じ 2 段）。**MCP には無い。**
-- **止める（承認なし・止めた口座でも・量の制限で待たない）**: `thth ads stop <名前> --by <名前>` が全部 PAUSED → Meta から読み直して確かめる → `spend_cap` を使った額まで下げる → THTH の止め。**「止まった」と出なければ管理画面で止める**（出力の `waiting_on_masaru` の 1 行を hub に送る）。一部だけなら `thth ads pause <名前> --id <id>|--all`。減らす `thth ads budget lower <名前> --adset <id> --lifetime <額>`・早める `thth ads end <名前> <adset_id> --end <時刻>`・台帳の上限を下げる `thth ads budget lower <名前> --monthly <額>`。MCP は `thth_ads_pause`・`thth_ads_stop`。
-- 月の上限は**実支出で縛る**: 使った見積もり＝口座の今月の実支出の全部＋終わっていない予約の残り（月末に始めて翌月に続く配信も翌月に数える）。THTH の見積もり（`thth ads budget show`）は Meta の請求書ではない。THTH の承認（digest・hub の番号）は取り違えを防ぐ柵で、最後の柵は masaru が入れた `spend_cap` と終了日。
+- **広告を出す・見張る・成績を読む・止めるときは、まず skill `thth-ads` を読む**（repo の `skills/thth-ads/SKILL.md`・`thth ads skill --print` で全文）。目的の決め方・見積もり・ピクセルと UTM・作る・人の承認・見張り・成績の読み方（0 と不明の違い）・止め方・報告の順と、お金の柵はそこにある。
+- 広告は投稿先の媒体ではないので `thth account` でなく `thth ads`。金額は**最小単位の整数**（JPY なら円）。
+- **お金が動く始める（`thth ads activate`）・延ばす（`thth ads extend`）は 2 段＋人の承認の hub の番号・CLI だけ**。MCP の広告の道具は `thth_ads_show`・`thth_ads_boost`（全部 PAUSED で作る）・`thth_ads_pause`・`thth_ads_stop` だけ。`spend_cap`・上限・旗を上げる命令は無い。
 - 見張り（`thth events`・dashboard の要対応・`thth morning`）: `ads_stop_unconfirmed`（`stop` が止まったと確かめられなかった・最優先）・`ads_active_outside_thth`（THTH の外で誰かが配信を始めた・最優先）・`ads_no_end_time`・`ads_account_status`・`ads_spend_cap_unset`・`ads_spend_cap_near`・`ads_budget_low`・`ads_spend_over_estimate`・`ads_token_expiring`（残り 14 日）・`ads_read_failed`。
 
 ## 何を拒むか

thth-5.6.3/skills/thth-ads/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: thth-ads
+description: THTH で Meta の広告（Facebook・Instagram）を 1 本出すとき、出した広告を見張る・成績を読む・止めるときに読む。目的の決め方から見積もり・ピクセルと UTM の確かめ・作る・人の承認・見張り・成績の読み方・止め方・報告までの順と、お金の柵。
+---
+
+# 広告を 1 本出す（thth ads）
+
+届ける流れ全体（有機の投稿・セルクマ・広告に進む条件・印の決まり）は skill `thth-flow` にある（別の書き手が作る）。ここは広告の 1 本だけ。
+
+広告の命令は `thth ads …`。金額は**最小単位の整数**（JPY なら円）。この手順の本文は `thth ads skill --print` でいつでも出せる。広告の命令の「次の一手」（json の `next_steps`）とエラーの文は、先頭でこの skill を示し、そのあとに個別の一手を書く。`next_steps` は上から順に読む。
+
+## お金の柵（先に読む）
+
+- **お金が動くのは配信を始めたときだけ。** 始める `thth ads activate` と延ばす・増やす `thth ads extend` は **2 段**で、2 段目に人（masaru）の承認の hub の番号が要る。LLM は 1 段目を打って digest と木を人に見せ、承認を待つ。**MCP には無い**（MCP の広告の道具は `thth_ads_show`・`thth_ads_boost`・`thth_ads_pause`・`thth_ads_stop` だけ）。
+- **上げる命令は無い。** `spend_cap` を上げる・外す、月の上限・1 操作の上限（`lifetime_budget_max`・`days_max`）・`ads_enabled`・`production` を上げるのは THTH の外（`spend_cap` は管理画面で masaru、上限と旗は VM の台帳）。頼まれても THTH で上げる道を探さない。
+- **`thth ads resume` は止めの印を外すだけの例外**（masaru 11/02）。2 段＋hub の番号が要り、広告は PAUSED のまま。外したあと配信するには、もう一度 `activate` の 2 段を通す。
+- **`spend_cap` の変更は 1 日 10 回まで**（Meta の決まり）。`stop` は `spend_cap` を使った額の近くまで下げるので、同じ日に `stop` を何度も打ち直さない。
+- 止める（`thth ads pause`・`thth ads stop`）は承認なしで通る。迷ったら止める側に倒す。
+
+## 0. 口座の用意（人が VM で）
+
+広告の口座の台帳を書く `thth ads add` と鍵を取る `thth ads auth <広告の口座> --by <名前>` は人が VM で打つ（MCP には無い）。用意ができたかは `thth ads doctor <広告の口座>` で見る。
+
+## 1. 目的を決める
+
+人と次のどれかを決める。`thth ads boost` の `--objective` に入る。
+
+- **反応**（いいね・コメント・シェア）: `--objective engagement`（本番で確かめた）。
+- **サイトへの誘導**: `--objective traffic`（本番未確認）。ピクセルと UTM を手順 3 で確かめる。
+- **認知**（たくさんの人に見せる）: `--objective reach`（本番未確認）。
+
+## 2. 出す前の見積もり（読むだけ）
+
+```
+thth ads estimate <広告の口座> --targeting '{"geo_locations":{"countries":["JP"]},"age_min":18}' --goal LINK_CLICKS --json
+```
+
+- `reach.users_lower_bound`〜`reach.users_upper_bound`: 狙う相手の人数の幅。-1 は「出せない」で、配信が止まる意味ではない。
+- `delivery.daily_outcomes_curve`: 予算あたりの見込み。`delivery.confident` が false なら Meta に確度の高い予測が無い（全部 0 の 1 点）。
+- `--goal` は `POST_ENGAGEMENT`・`LINK_CLICKS`・`LANDING_PAGE_VIEWS`・`REACH`・`IMPRESSIONS`。
+
+## 3. サイトへの誘導なら: ピクセルと UTM を確かめる
+
+**ピクセルが要るかの判断の表**（入れるかは広告を出すときにこの表で決める）:
+
+| 広告の目的 | ピクセルが要るか | 無いとどうなるか |
+|---|---|---|
+| 反応（`--objective engagement`・最適化は POST_ENGAGEMENT） | 要らない | 何も欠けない（反応は `engagement` で読める） |
+| サイトへの誘導（`--objective traffic`・最適化は LINK_CLICKS） | 無くても配信できる | `link_clicks`・`outbound_clicks` は読める。`landing_page_views`（頁が開いた）が測れず `not_measured_or_left` になる |
+| 頁が開いた数で最適化（LANDING_PAGE_VIEWS） | 要るものとして扱う | THTH の boost はこの最適化で作らない（見積もり `--goal LANDING_PAGE_VIEWS` だけ）。Meta の公式の文書でピクセルが要るとは確かめられていない |
+
+ピクセルをサイトに入れると Meta への外部送信が増える（サイトのプライバシーの頁の更新も要る）。**入れる前に masaru へ 1 行**（何のサイトに・どのピクセルを・なぜ）を送り、返事を待つ。
+
+1. `thth ads doctor <広告の口座> --json` の `next_steps` を読む（`thth ads show <広告の口座> --json` にも同じ欄がある）。
+   - `kind: pixel_create` … 広告アカウントにピクセルが無い。人にイベントマネージャでピクセルを作ってもらう（THTH からは作らない）。
+   - `kind: pixel_install` … ピクセルはあるが動いた記録が無い。**誘導先のサイトの repo で**、文に出ているピクセルの id の基本のコードを全部の頁の `<head>` に入れる（入れ方は文に出る公式の文書）。THTH はサイトのコードに触らない。
+   - `kind: pixel_check_page` … ピクセルは動いている。誘導先の頁にもコードが入っているかを確かめる。
+   - `kind: landing_url_unknown` … 誘導先の URL を `--landing-url` か台帳の `landing_url` に書くと、文に URL が入る。
+2. 入れたら `thth ads doctor <広告の口座>` を打ち直し、「ピクセル」の行が ○（最後に動いた時刻が出る）になるのを見る。
+3. **UTM**: 有機の投稿と同じ鍵にそろえる（10/27 に決まった形）。有機は `utm_source=<媒体>&utm_medium=social&utm_campaign=<原稿のファイル名、拡張子なし>`、広告は `utm_medium=paid` で campaign は同じ。`thth ads boost` の `--utm-campaign <元の投稿の原稿のファイル名、拡張子なし>` で `utm_source=<出し先の 1 つ目>&utm_medium=paid&utm_campaign=<それ>` を組む。違う形が要るときだけ `--url-tags 'key=value&key=value'`（無ければ台帳の `url_tags`）。どれもクリエイティブの `url_tags` として送られ、広告から押されたリンクに付く。口座名を campaign にしない（記事ごとに分けられない）。
+
+## 4. 作る（全部 PAUSED・お金は動かない）
+
+```
+thth ads boost <広告の口座> --post <post_id> --lifetime <額> --end <終了の時刻> --objective traffic \
+  --utm-campaign <原稿のファイル名> --landing-url <誘導先の URL> --by <名前> --json
+```
+
+- 投稿は `--post <post_id>`（THTH で出したページの投稿）か `--object-story-id <ページID>_<数字>`。
+- `--end` は必須。1 操作の上限（通しの予算・期間）を越える指定は作らない。`--platforms facebook,instagram` で Instagram にも出す。
+- 出力の `created`（キャンペーン・広告セット・クリエイティブ・広告の id）と `next_steps` を読む。サイトへの誘導でピクセルが動いていなければ、ここでも手順 3 の一手が出る。
+
+## 5. 人の承認を得て始める
+
+1. `thth ads activate <広告の口座> <campaign_id> --by <名前>` … 1 段目。digest と木（予算・期間・広告）が出る。**何も変わらない。**
+2. digest・予算・期間・見積もりを人に見せ、hub で承認の番号をもらう。
+3. `thth ads activate <広告の口座> <campaign_id> --confirm <digest> --approval <hub の番号> --by <名前>` … 2 段目（人か、人が許したときだけ）。Meta から木を読み直し、変わっていれば `ads_tree_changed` で断る。
+
+## 6. 見張る
+
+```
+thth ads watch <広告の口座> <campaign_id> --stop-at-spend <額> --by <名前>
+```
+
+- `--stop-at-spend <額>` か `--stop-at-impressions <数>` に達したら `thth ads stop` と同じに止める。指定なしなら配信が始まった（表示が 1 以上）ら知らせて終わる。`--interval <秒>`・`--until <時刻>` で間隔と終わりを決める。
+- 終わりの表示に反応とサイトへの誘導の数も出る。
+- 普段の見張りは `thth ads show <広告の口座>` と `thth events` の要対応（`ads_stop_unconfirmed`・`ads_active_outside_thth` は最優先）。
+
+## 7. 成績を読む
+
+```
+thth ads insights <広告の口座> --preset maximum --level campaign --json
+thth ads insights <広告の口座> --preset last_7d --by age-gender
+```
+
+- `--preset` の `last_7d` などは**今日を含まない**。今日の分は `--preset today` か `--preset maximum`。`--since YYYY-MM-DD [--until YYYY-MM-DD]` でも読める。
+- **反応** `engagement`: `reactions`（いいね・リアクション）・`comments`・`shares`・`photo_views`・`page_likes`。
+- **サイトへの誘導** `site`: `link_clicks`・`outbound_clicks`（サイトへ出たクリック）・`landing_page_views`（頁が開いた）・`inline_link_clicks`。
+- **1 件あたり** `cost_per`: 上の数ごとの spend ÷ 件数（0 件・不明は null）。
+- **効率** `efficiency`（Meta の計算済み）: `frequency`・`cpm`・`ctr`・`cpc`・`cost_per_unique_click`・`inline_link_click_ctr`・`cost_per_inline_link_click`・`outbound_clicks_ctr`・`cost_per_outbound_click`。
+- **動画** `video`: `plays`・`p25`〜`p100`（見られた深さ）・`avg_time_watched`・`cost_per_thruplay`。動画でない広告では null。
+- **内訳** `--by age-gender|region|country|placement|device|hour`: 1 区分 1 行。内訳つきは効率・動画を出さない。`hour` では reach が 0（Meta の決まり）。
+- `actions`・`outbound_clicks_raw` は Meta の生の行。
+
+**0 と不明を分けて読む**（`site.why` と `engagement_unknown`）:
+
+- `reported`: Meta が返した数。`zero_reported_list`: 並びに行が無い＝0（Meta は 0 の行を出さない）。
+- `no_link_clicks`: リンクが 1 度も押されていないので本当に 0。
+- `not_measured_or_left`: リンクは押されたのに頁が開いた記録が無い。**0 と書かない**。頁の計測（ピクセル）が無いか、開く前に離れた。このとき `next_steps` にピクセルの一手が出る。
+- `actions_missing`・`outbound_clicks_missing` など、値が null: 欄が無い＝不明。
+- `clicks` は広告のどこを押しても数える。**リンクのクリックではない**。サイトへの誘導は `site` を読む。
+- 品質の評価（quality_ranking など）は THTH では読まない（公式の欄の一覧で名前を確かめられていない）。
+
+## 8. 止める
+
+- 全部止める: `thth ads stop <広告の口座> --by <名前>`。全部 PAUSED → Meta から読み直して確かめる → `spend_cap` を下げる → THTH の止め。「止まった」と出なければ管理画面で止めてもらう（出力の `waiting_on_masaru` の 1 行を hub へ）。
+- 一部だけ: `thth ads pause <広告の口座> --id <id>`（`--all` で全部）。
+- 減らす: `thth ads budget lower <広告の口座> --adset <id> --lifetime <額>`。早く終える: `thth ads end <広告の口座> <adset_id> --end <時刻|now> --by <名前>`。
+- 今月の見積もり: `thth ads budget show <広告の口座>`（Meta の請求書ではない）。
+
+## 9. 人への報告
+
+1 本ごとに、次を短く渡す: 目的・期間・使った額（`spend`）・表示とリーチ・反応の内訳・サイトへの誘導（リンククリック・サイトへ出たクリック・頁が開いた）と 1 件あたり・**0 か不明か**（不明ならその理由と `next_steps` の一手）・止めたか。数は `thth ads insights … --json` の値をそのまま書き、推して埋めない。

thth-5.6.3/skills/thth-flow/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: thth-flow
+description: 記事を軸に「調べる→はてブ→はてなブログ→本体の記事→告知とセルクマ→広告」を回すとき、キャンペーン（糸）の宣言を書くとき、原稿のリンクに印（UTM）を付けるとき、効いたかを測るときに呼ぶ。各段で叩く THTH の命令と、数の読み方・広告に進む条件をまとめた流れの型。
+---
+
+# THTH — 届ける流れの型（thth-flow）
+
+THTH の出力が「次はこれ」と言う前に、まずこの型を読む。命令ひとつずつの詳しい使い方は skill `thth`（`skills/thth/SKILL.md`）、広告の段の手順は skill `thth-ads` に任せる。ここに書くのは流れの形と、THTH が触る所だけ。
+
+**根っこは効果測定。** あとから取り直せないのは 3 つだけ——投稿の URL の印（UTM）・原稿の札 `thread:`・広告の `url_tags`。これは出す前に必ず付ける。数の読みは後からでもできる。
+
+## 1. 流れの型（段の名と順）
+
+| 段 | 中身 | 宣言に書く行の例 |
+|---|---|---|
+| `collect` | 調べる・はてブで集める | `- collect: hatena_bookmark need=3`（タグは既定で糸の id） |
+| `diary` | はてなブログに仮説を書く | `- diary: hatenablog` |
+| `article` | 本体のサイトの記事を出す・直す | `- article: site`（出来事 `article_published` で満たす） |
+| `promote` | 告知（Threads・X・Facebook・Instagram） | `- promote: threads,x,facebook need=3` |
+| `selfbm` | セルクマ（自分の記事を自分のはてな ID で） | 下の §4 を見る |
+| `boost` | 広告（有機の反応を見てから 1 本だけ） | 段 1（5.7）で入る予定。今は宣言に書かない |
+| `warm` | 返信を返す | `- warm: threads replies_within_hours=24` |
+
+- 段は窓口が選ぶ。全部は要らない。上から順に満たす形で、THTH は読んで数えるだけ（原稿を書かない・段を進めない・選ばない）。
+- 段の名は自由（`[a-z][a-z0-9_]` 32 字まで）。`collect`・`diary`・`article`・`announce`・`warm` だけ画面に日本語の名が出る。`promote`・`selfbm` は今は「n 段目」と出る。
+- 媒体として書けるのは今 9 つ: `hatena_bookmark`・`hatenablog`・`site`・`threads`・`x`・`bluesky`・`mastodon`・`facebook`・`instagram`。`ads`（広告）は段 1（5.7）で入る予定で、今書くと `stage_medium_unknown`。
+- **台帳の更新は THTH の段ではない。** 知識の側（各 repo）の仕事。糸のファイルには出来事の 1 行だけ残す: `- 2026-11-03 researched <短い文>`・`hypothesis`・`article_published`・`closed`。`researched` は collect、`hypothesis` は diary の本数の代わりになる。
+- 宣言の置き場と書式は skill `thth` の「キャンペーンとシリーズ（scenario）」の節。原稿の札 `thread: <id>` は承認の指紋に入らないので、あとから足しても再承認は要らない。
+
+## 2. 印（UTM）の決まり
+
+| 何 | 印 |
+|---|---|
+| SNS の告知（有機） | `?utm_source=<threads|x|facebook|instagram>&utm_medium=social&utm_campaign=<原稿のファイル名、拡張子なし>` |
+| 広告 | 同じ `utm_campaign`、`utm_medium=paid`（`utm_source=facebook|instagram`）。付け方は skill `thth-ads` |
+| セルクマ・はてなブログからの導線 | 印を付けない（付けると別のエントリーになる）。参照元（`b.hatena.ne.jp`・`<blog>.hatenablog.com`）で見る |
+
+- **印は窓口が原稿に書く。THTH は本文を書き換えない**（承認の指紋が変わるため）。
+- いま印が付いているのはほぼ Facebook の原稿だけ。**Threads・X の原稿にも次の原稿から付ける。** 承認済みの原稿は付け直さない。
+- `utm_campaign` を原稿のファイル名にしておけば、GA4 の campaign → 原稿 → `thread:` → 糸、と新しい札なしで結べる。口座名（例 `utm_campaign=kopicha`）にしない——記事ごとに分けられなくなる。
+- THTH のクリックの照合は `utm_*` を外して数えるので、印を付けても数え方は壊れない。
+
+## 3. 各段で叩く THTH の命令
+
+| 段 | 命令（実在するものだけ） |
+|---|---|
+| 全体 | `thth scenario <project> --json`（糸と型の一覧）・`thth scenario show <project> <id> --json`（段ごとの原稿と状態・`next`）・`thth scenario lint <project>`（宣言の誤り・宣言の無い札）・`thth dashboard <project> campaign <id> --json` |
+| collect | `thth bookmark add <口座> --url <URL> --comment … --tags <糸の id>`（二段・1 段目は表示と digest だけ）・`thth bookmark list <口座>` |
+| diary | 原稿を queue に置いて `thth approve` の二段。`thth deliveries <口座|project> [--article <記事の id>]` で配信の状態と配信 id |
+| article | 本体の記事は各 repo の手順で出す。出たら糸のファイルに `- <日付> article_published …` の 1 行 |
+| promote | 原稿に `thread: <id>`・`goal: click`・印つきの URL → `thth lint` → `thth approve` の二段 |
+| selfbm | `thth bookmark add <口座> --delivery <配信 id> --comment … --tags …`（§4 の柵） |
+| boost | skill `thth-ads`（`thth ads boost` は全部 PAUSED で作るだけ、お金が動くのは `thth ads activate` の二段＋hub の承認） |
+| warm | `thth replies`・`thth unanswered <口座> --since 7d --json`・返事は承認の二段 |
+| 測る | `thth after <口座>|--project <p> --json`・`thth analytics-report <口座> --per-post-clicks --since 30d --json`・`thth article reactions <project> --article <記事の id> --json`・`thth events <project> --since 7d --json`（`bookmark_received`・`scenario_stalled`）・`thth measured <口座> --json`（`file` 欄で原稿の名と結ぶ） |
+
+### 測りの読み方
+
+- **分母と窓を必ず添えて言う。** `null`・`cannot_say` は「取れない」で、0 ではない。0 と書かない。
+- 投稿ごとのクリックが THTH で取れるのは Threads だけ（`--per-post-clicks`・同じリンク先を前後 72 時間で 1 本だけが使った投稿 `unique_url_72h`）。X・Facebook・Instagram の投稿ごとのクリックは THTH に無い。Meta の `clicks` はリンク以外も含む。**記事への訪問はサイト側（GA4）で見るのが本筋**——いまは各サイトの GA4 の画面で `utm_campaign` を見る（機械で読むのは hub の仕事・段 2〜3 で入る予定）。
+- セルクマの効きは「第三者のブックマークが付いたか」: `thth events` の `bookmark_received`、`thth article reactions`。はてなブログの PV は取らない（公式の口が無い）。
+- 効いた・効かなかったは施策としてプラザに置く: `thth plaza post <口座> --kind measure --from after <口座>`（または `--from analytics-report <口座>`）。糸 1 本まるごとを観測として付ける `--from scenario` は段 4 で入る予定。
+
+## 4. セルクマの柵
+
+はてなの原文: 自分が運営するサイトを自分のアカウントでブックマークするのは問題にしていない（ただし宣伝目的・機械的な高頻度はスパムと判断されうる）。THTH の柵はこのまま使う:
+
+- 自分の記事は `--delivery`（配信の台帳にある自分の記事）で付ける。主体ごとに 1 日 1 件。同じページは owner をまたいで 1 回だけ。
+- コメントに運営者であることを書く（1 段目に「運営者であることが分かる文に」と出る）。
+- 二段の承認。まとめ打ち（`thth bookmark batch`）や timer に混ぜず、人がその場で `bookmark add` を打つ。記事が出た直後に 1 件。
+- 「何件で新着に載るか」を試さない（表示の仕組みの検証はガイドラインが禁じている）。URL に印を付けない。
+- **宣言の段として数えるのは段 1（5.7）から**（`hatena_bookmark target=own`）。いまの `hatena_bookmark` の段は THTH で付けたブックマークをタグで数えるだけで、自分の記事か他人のページかを分けない。いま `selfbm` の段を書くなら、collect と別のタグ（例 `- selfbm: hatena_bookmark tag=<id>-self`）をセルクマにだけ付ける。
+
+## 5. 広告に進む条件とピクセル
+
+- **有機の告知を出して 48〜72 時間の反応を見てから**（`thth after`・`--per-post-clicks`）、効いた 1 本だけを押し出す。THTH は選ばない（数を並べるだけ）。選ぶのは窓口と人。
+- 手順・承認・止め方は skill `thth-ads`。
+
+| 広告の目的 | ピクセル | 無いとどうなるか |
+|---|---|---|
+| 反応（`--objective engagement`） | 要らない | 何も欠けない |
+| サイト誘導（`--objective traffic`・リンクのクリックで最適化） | 無くても出せる | 「頁が開いた」（`landing_page_view`）が取れない |
+| サイト誘導で「頁が開いた」に最適化 | **要る** | 作れない・最適化が効かない |
+
+- ピクセルをサイトに入れるのは窓口の仕事。Meta への外部送信が増えるのでプライバシーの頁も直す。**入れる前に masaru へ 1 行。**
+
+## 6. 知識の側の手順（THTH の外）
+
+台帳の更新・本体の記事の出し方・自分のサイトの GA4 の見方・プライバシーの文は、各メディアの repo の `docs/sns/README.md` などに書く（例: asmon の `docs/sns/README.md`）。そこからこの skill へリンクする。ここには写さない。
+
+設計の正本: `docs/設計_効果測定と連動_2026-11-03.md`（段 0〜5）。

thth-5.6.3/tests/test_ads_boost_563.py

@@ -0,0 +1,93 @@
+"""5.6.3: boost のリンクの印（url_tags）と、サイトへの誘導（traffic）のあとの次の一手。偽の Meta だけ。
+
+- `--url-tags`（無ければ台帳の `url_tags`）をクリエイティブの `url_tags` として送る（AdCreative の文書）。
+- traffic で作ったら、ピクセルを**読むだけ**で確かめ、動いていなければ次の一手を返す。**先頭は skill。**
+- 書く口は増やさない（ピクセルを作る・変える POST は無い）。
+"""
+from __future__ import annotations
+
+import json
+
+import pytest
+
+from thth.ads import guide, ledger, ops
+from tests.test_meta_stage5 import ACT, NAME, STORY, V, end_in, env, posts, setup_ledger  # noqa: F401
+
+
+def test_url_tagsを付けるとクリエイティブにだけ送り_記録に残す(env):
+    setup_ledger(env)
+    out = ops.boost(NAME, by="masaru", object_story_id=STORY, lifetime_minor=500, start="now", end=end_in(1),
+                    url_tags="utm_source=facebook&utm_medium=paid&utm_campaign=kopicha")
+    creative = posts(env, "/adcreatives")[0]["form"]
+    assert creative["url_tags"] == ["utm_source=facebook&utm_medium=paid&utm_campaign=kopicha"]
+    assert creative["object_story_id"] == [STORY]
+    assert all("url_tags" not in c["form"] for c in posts(env) if not c["path"].endswith("adcreatives"))
+    assert out["plan"]["url_tags"].startswith("utm_source=facebook")
+    rows = [r for r in ops.read_ops(NAME) if r["op"] == "boost"]
+    assert rows[-1]["plan"]["url_tags"] == out["plan"]["url_tags"]
+    # 印が無ければ送らない（既定の振る舞いは変えない）
+    ops.boost(NAME, by="masaru", object_story_id=STORY, lifetime_minor=500, start="now", end=end_in(1))
+    assert "url_tags" not in posts(env, "/adcreatives")[-1]["form"]
+    assert [s["kind"] for s in ops.boost(NAME, by="masaru", object_story_id=STORY, lifetime_minor=500, start="now",
+                                         end=end_in(1))["next_steps"]] == ["skill"]
+
+
+def test_utm_campaignだけなら有機と同じ鍵でmediumだけpaidの印を組む(env):
+    """10/27 に窓口が決めた形（有機 utm_medium=social）に揃え、広告は paid・campaign は原稿のファイル名。"""
+    setup_ledger(env)
+    out = ops.boost(NAME, by="masaru", object_story_id=STORY, lifetime_minor=500, start="now", end=end_in(1),
+                    utm_campaign="2026-11-04-fb-sakura")
+    tags = "utm_source=facebook&utm_medium=paid&utm_campaign=2026-11-04-fb-sakura"
+    assert posts(env, "/adcreatives")[0]["form"]["url_tags"] == [tags] and out["plan"]["url_tags"] == tags
+    # --url-tags を渡せばそちらが先
+    ops.boost(NAME, by="masaru", object_story_id=STORY, lifetime_minor=500, start="now", end=end_in(1),
+              utm_campaign="x", url_tags="utm_source=a")
+    assert posts(env, "/adcreatives")[-1]["form"]["url_tags"] == ["utm_source=a"]
+    with pytest.raises(ops.OpsRefused) as exc:
+        ops.boost(NAME, by="masaru", object_story_id=STORY, lifetime_minor=500, start="now", end=end_in(1),
+                  utm_campaign="a&utm_source=b")
+    assert exc.value.code == "ads_utm_campaign_invalid"
+
+
+def test_台帳のurl_tagsとlanding_urlを使い_形の違う物は作る前に断る(env):
+    setup_ledger(env)
+    path = ledger.path_for(NAME)
+    raw = json.loads(open(path, encoding="utf-8").read())
+    raw.update(url_tags="utm_source=facebook&utm_campaign={{campaign.id}}", landing_url="https://kopicha.example/lp")
+    open(path, "w", encoding="utf-8").write(json.dumps(raw))
+    out = ops.boost(NAME, by="masaru", object_story_id=STORY, lifetime_minor=500, start="now", end=end_in(1))
+    assert posts(env, "/adcreatives")[0]["form"]["url_tags"] == ["utm_source=facebook&utm_campaign={{campaign.id}}"]
+    assert out["plan"]["landing_url"] == "https://kopicha.example/lp"
+    before = len(posts(env))
+    for kwargs, code in (({"url_tags": "utm_source=a b"}, "ads_url_tags_invalid"),
+                         ({"url_tags": "javascript:alert(1)"}, "ads_url_tags_invalid"),
+                         ({"landing_url": "ftp://x"}, "ads_landing_url_invalid")):
+        with pytest.raises(ops.OpsRefused) as exc:
+            ops.boost(NAME, by="masaru", object_story_id=STORY, lifetime_minor=500, start="now", end=end_in(1),
+                      **kwargs)
+        assert exc.value.code == code
+    assert len(posts(env)) == before
+    raw["url_tags"] = "壊れた 印"
+    open(path, "w", encoding="utf-8").write(json.dumps(raw))
+    with pytest.raises(ledger.AdAccountError):
+        ledger.load(NAME)
+
+
+def test_trafficで作ったらピクセルを読み_動いていなければ入れる一手を返す_先頭はskill(env):
+    setup_ledger(env)
+    env["meta"].fail[("GET", V + f"/act_{ACT}/adspixels")] = (200, {"data": [{"id": "555", "name": "p"}]})
+    out = ops.boost(NAME, by="masaru", object_story_id=STORY, lifetime_minor=500, start="now", end=end_in(1),
+                    objective="traffic", landing_url="https://kopicha.example/lp")
+    kinds = [s["kind"] for s in out["next_steps"]]
+    assert kinds == ["skill", "pixel_install", "url_tags_unset"]
+    assert out["skill"]["name"] == "thth-ads"
+    assert "誘導先 https://kopicha.example/lp のサイトにピクセル 555 の基本のコードを入れる" in out["next_steps"][1]["text"]
+    assert guide.PIXEL_DOC_URL in out["next_steps"][1]["text"]
+    # ピクセルが動いていて印も付けたなら skill だけ
+    env["meta"].fail[("GET", V + f"/act_{ACT}/adspixels")] = (
+        200, {"data": [{"id": "555", "last_fired_time": "2026-11-03T05:00:00+0000"}]})
+    out = ops.boost(NAME, by="masaru", object_story_id=STORY, lifetime_minor=500, start="now", end=end_in(1),
+                    objective="traffic", url_tags="utm_source=facebook")
+    assert [s["kind"] for s in out["next_steps"]] == ["skill"]
+    # ピクセルを読む口は GET だけ（作る・変える POST は無い）
+    assert not any("adspixels" in c["path"] for c in posts(env))