fetch-engagement

star 0

influxプロジェクトのVNCコンテナ経由でX(Twitter)投稿のエンゲージメント（likes/views/retweets/replies/bookmarks）を取得する。単体URL・URLリスト・候補Markdown抽出に対応。複数アカ対応（`--account`）。取得結果を素材テーブルに自動追記できる。

666666ma999999 By 666666ma999999 schedule Updated 4/23/2026
play_arrow Run Skill in Manus View GitHub

name: fetch-engagement description: influxプロジェクトのVNCコンテナ経由でX(Twitter)投稿のエンゲージメント（likes/views/retweets/replies/bookmarks）を取得する。単体URL・URLリスト・候補Markdown抽出に対応。複数アカ対応（--account）。取得結果を素材テーブルに自動追記できる。 keywords: engagement, エンゲージメント, X投稿, Twitter, likes, views, impression, いいね数, リーチ, 教師データ, 実測検証, 複数アカウント triggers: - エンゲージメント取得 - いいね数取得 - X投稿の実測 - バズ投稿検証 - 候補URLの数値確認 - fetch engagement allowed-tools: [Read, Write, Glob, Grep, Bash]

X Post Engagement Fetch Skill

When to use

  • Grok検索等で収集したX投稿URLの実測エンゲージメントを取りたい時
  • 教師データ候補の振り分け（いいね100+フィルタ）を実行したい時
  • 投稿後の実績値を記録したい時
  • /record-result スキルの裏付け数値が必要な時

Not for

  • ブックマーク一括取得 → fetch-bookmarks スキル
  • X投稿そのものの生成 → /generate-x-post, /generate-x-article
  • Cookie更新 → influx側 refresh-x-cookies スキル（~/Desktop/biz/influx/.claude/skills/refresh-x-cookies/SKILL.md）

Prerequisites

  • influxプロジェクト: ~/Desktop/biz/influx（INFLUX_ROOT 環境変数 or デフォルト）
  • Docker: docker-compose.vnc.yml が存在し xstock-vnc コンテナが起動可能
  • Cookie: x_profiles/<account>/cookies.json が有効（account は kabuki666999 or maaaki）
    • 14日以上経つと期限切れの可能性。refresh手順は influx側 refresh-x-cookies スキル参照
  • make_article側ラッパー: scripts/fetch_engagement_via_influx.sh

Workflow

Step 1: 前提確認

ls scripts/fetch_engagement_via_influx.sh && echo "OK"

Step 2: VNCコンテナ起動確認

ラッパー側で自動pre-flightするが明示確認する場合:

docker ps --filter name=xstock-vnc --filter status=running -q
# 空なら
cd ~/Desktop/biz/influx && docker compose -f docker-compose.vnc.yml up -d

Step 3: Cookie有効性確認（自動）

ラッパー fetch_engagement_via_influx.sh がバッチ先頭で x_profiles/$ACCOUNT/cookies.json のmtimeを自動確認:

  • age < 12日: [PRE-FLIGHT] Cookie age=Nd for account=XXX: OK
  • 12日 ≤ age < 14日: [WARN] 近日中 refresh 推奨
  • age ≥ 14日 or ファイル不在: [ERROR] refresh手順表示して exit 3

手動確認:

python3 -c "import os, time; p='$HOME/Desktop/biz/influx/x_profiles/maaaki/cookies.json'; print(int((time.time() - os.path.getmtime(p))/86400), 'days')"

Cookie期限切れ時の対応 → influx側 refresh-x-cookies スキル を参照:

# 要するに1コマンド（詳細はスキル参照、普段使いChromeでX ログイン済み前提）
cd ~/Desktop/biz/influx
python3 scripts/import_chrome_cookies.py --chrome-profile "Default"   --account maaaki
python3 scripts/import_chrome_cookies.py --chrome-profile "Profile 2" --account kabuki666999

Step 4: エンゲージメント取得

パターンA: 単体URL

bash scripts/fetch_engagement_via_influx.sh --url https://x.com/user/status/123 --no-update-table
# 明示アカウント指定:
bash scripts/fetch_engagement_via_influx.sh --url ... --account kabuki666999 --no-update-table

パターンB: URLリストファイル

bash scripts/fetch_engagement_via_influx.sh --urls-file /tmp/urls.txt --account maaaki

パターンC: 候補Markdown自動抽出（最頻用）

bash scripts/fetch_engagement_via_influx.sh --urls-from-candidates
# デフォルトaccount=maaaki, デフォルトcandidates=output/plans/claude_tips_theme_a_b_candidates.md

共通オプション:

  • --account <name>: influx x_profiles アカウント名（default: maaaki、他: kabuki666999）
  • --out <path>: 出力JSONL先
  • --threshold <n>: 素材テーブル追記閾値（default: 100）
  • --no-update-table: 素材テーブル更新をスキップ

Step 5: 結果確認

wc -l output/engagement/*.jsonl
head -3 output/engagement/*.jsonl | python3 -c "
import sys, json
for l in sys.stdin:
    d = json.loads(l)
    print(f'  {d[\"url\"][:60]}  {d[\"status\"]:12s}  likes={d.get(\"likes\",0)}')
"
cat output/engagement/*.skipped.log  # スキップ記録

Step 6: 素材テーブル更新（手動起動）

ラッパーが --no-update-table でない限り自動。手動起動:

python3 scripts/update_material_table.py \
  --jsonl output/engagement/YYYYMMDD.jsonl \
  --candidates output/plans/claude_tips_theme_a_b_candidates.md \
  --target output/plans/claude_tips_planmd.md \
  --threshold 100

更新ルール:

  • status=ok かつ likes >= threshold のみ採用
  • candidates.md の「テーマA」→ ### 失敗系(F) に F1, F2, ...
  • candidates.md の「テーマB」→ ### コスト系(C) に C1, C2, ...
  • 既存URLは冪等性のためskip

Output

JSONLスキーマ（1URL = 1行）

成功:

{"url": "https://x.com/...", "status": "ok", "likes": 123, "views": 4567,
 "retweets": 8, "replies": 2, "bookmarks": 10, "scraped_at": "2026-04-22T08:00:00+09:00"}

失敗:

{"url": "https://x.com/...", "status": "deleted", "error_detail": "...",
 "scraped_at": "2026-04-22T08:00:00+09:00"}

status値:

  • ok: 正常取得
  • deleted: 削除済み投稿
  • protected: 鍵アカウント
  • login_required: Cookie失効（バッチ途中の場合のみ記録、先頭検出時はexit 3で停止）
  • rate_limited: X側レート制限
  • other: その他エラー

生成ファイル

  • 生JSONL: output/engagement/YYYYMMDD.jsonl
  • スキップログ: output/engagement/YYYYMMDD.skipped.log
  • 素材テーブル（更新済み）: output/plans/claude_tips_planmd.md

Failure handling

症状 原因 対処
exit 3, Cookie期限切れ X.comセッション失効 or cookies.jsonが14日超 influx側 refresh-x-cookies スキル 参照。1行: python3 scripts/import_chrome_cookies.py --chrome-profile <profile> --account <account>
exit 3, Cookie not found 指定アカウントの cookies.json 不在 初回セットアップ: refresh-x-cookies スキル参照
exit 2, コンテナ起動失敗 Docker未起動 or compose定義不正 cd ~/Desktop/biz/influx && docker compose -f docker-compose.vnc.yml up -d
Missing X server or $DISPLAY DISPLAY未設定で docker exec 実行 ラッパー使用必須。直接呼ぶなら -e DISPLAY=:99 を付ける
全URLが status=other DOM selector変化 or BOT検知 _scrape_impressions / _scrape_metric のselector を最新仕様に更新
特定URLが status=deleted 投稿削除済み 正常動作。skipped.log に記録

実測パフォーマンス

  • Cold start含む1URL: 約11.5秒
  • 連続処理（ブラウザ再利用）: 1URL 2-3秒
  • 34URL完走: 約2分（目標5分以内 ✓）

関連ファイル

  • ラッパー: ~/Desktop/biz/make_article/scripts/fetch_engagement_via_influx.sh
  • 素材更新: ~/Desktop/biz/make_article/scripts/update_material_table.py
  • 本体: ~/Desktop/biz/influx/scripts/fetch_engagement.py
  • コアクラス: ~/Desktop/biz/influx/extensions/tier3_posting/impression_tracker/scraper.py
  • Cookie管理: ~/Desktop/biz/influx/.claude/skills/refresh-x-cookies/SKILL.md（Canonical）
  • 抽出スクリプト: ~/Desktop/biz/influx/scripts/import_chrome_cookies.py
Install via CLI
npx skills add https://github.com/666666ma999999/claudecode --skill fetch-engagement
Repository Details
star Stars 0
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator
666666ma999999
666666ma999999 Explore all skills →