X HarnessのリサーチとAPIコスト管理｜無料収集・日次監視・障害対応

無料収集とX APIを使い分け、海外ネタの発見、投稿・動画・長文下書き、API使用量の日次監視、更新と障害対応を運用化します。 twitter-cliのCookie認証は収集専用サブアカウントへ隔離し、書き込みは公式APIへ限定します。 3つの同梱スキルとGrowth承認画面を使い、収集・翻訳・生成・予約を承認付きで流します。 endpoint別・日別・gate別の利用量を見て、異常増加を止めてから原因を調べます。

この記事はHarness Academyの教材データを基に、各Harnessの公式リポジトリにある実装箇所と照合して構成しています。秘密情報や本番データを記事・AIチャットへ貼らず、外部送信は必ず検証対象を限定してください。

最初に確認すること

• 無料収集とX APIを使い分けてリサーチする: 検索・投稿収集・プロフィール確認を費用とアカウントリスクの両方を管理して行える
• 海外ネタ発見から投稿・動画・長文下書きまでを作る: ソースの出典を保ったまま、投稿案・動画引用案・記事下書きを承認キューへ送れる
• API使用量とコスト事故を日次で監視する: X API readの急増を早期発見し、ゲート・同期・検索のどこが原因か切り分けられる
• 更新・テスト・障害対応を本番運用へ固定する: 自社変更と公式更新を分離し、test・typecheck・build・migration・rollback付きで安全に更新できる

無料収集とX APIを使い分けてリサーチする

twitter-cliのCookie認証は収集専用サブアカウントへ隔離し、書き込みは公式APIへ限定します。

この工程のゴール: 検索・投稿収集・プロフィール確認を費用とアカウントリスクの両方を管理して行える

MCPのscrape_user_posts、scrape_search、scrape_post、scrape_userはtwitter-cliをローカル実行し、X APIの読み取り課金を避けます。一方、投稿やDMなどのwriteはX API経由です。

Cookie認証は公式APIとは異なる運用リスクがあります。収集専用のサブアカウントを使い、auth_tokenとct0をWorkerやD1へ送らず、ローカルMCP設定だけへ保存します。利用規約・アカウントリスクを受容できない場合は使いません。

手順

1. 収集目的を限定

検索語、対象、件数、頻度、保存期間を決めます。

2. 専用アカウントを分離

メイン投稿アカウントのCookieを使わず、収集専用アカウントを用意します。

3. ローカルだけへ設定

auth_tokenとct0をMCP環境へ入力し、Git、Worker、D1へ保存しません。

4. 最小件数で検証

一つの検索を少件数で実行し、必要なデータだけを残します。

完了条件

• CookieがローカルMCP設定だけに保存
• 投稿用と収集用のアカウントを分離
• 最小件数で一回だけ検証
• 無料収集と公式APIのリスク差を理解

注意: 無料収集は『無制限・無リスク』ではありません。Xの利用規約とアカウント状態を確認し、異常時は自動再試行せず停止します。

Academy教材: X Growthとコストを管理する / Lesson 19-1

海外ネタ発見から投稿・動画・長文下書きまでを作る

3つの同梱スキルとGrowth承認画面を使い、収集・翻訳・生成・予約を承認付きで流します。

この工程のゴール: ソースの出典を保ったまま、投稿案・動画引用案・記事下書きを承認キューへ送れる

x-growth-discoverは候補発見、x-growth-articleは長文記事下書き、x-growth-videoは動画候補から引用投稿の生成・予約を担当します。結果はgrowth sources、articles、draftsへ保存され、管理画面でレビューします。

自動生成物は事実確認、権利、引用元、誤訳、同一内容の重複を確認してから公開します。—autoは便利ですが、対象アカウント、検索条件、最大件数、予約上限、停止方法が固まるまでは使いません。

手順

1. テーマを固定

対象読者、テーマ、除外語、期間、最低反応数を決めます。

2. 候補を保存

元post ID、author、原文、翻訳、要約、動画URL、テーマを残します。

3. 下書きを生成

引用投稿・通常投稿・記事のどれにするか決め、出典と主張を照合します。

4. 承認して予約

Growth画面で採用・却下し、対象と時刻を確認後に予約します。

完了条件

• 元post IDと出典が保存される
• 公開せず承認キューで止まる
• 事実・権利・誤訳を確認
• X APIの不要なreadを避ける

注意: 引用元が公開されていても、画像・動画・長文の再利用権が自動的に得られるわけではありません。必要に応じて許諾や自社素材へ差し替えます。

Academy教材: X Growthとコストを管理する / Lesson 19-2

API使用量とコスト事故を日次で監視する

endpoint別・日別・gate別の利用量を見て、異常増加を止めてから原因を調べます。

この工程のゴール: X API readの急増を早期発見し、ゲート・同期・検索のどこが原因か切り分けられる

利用量画面は期間、アカウント、endpoint、gate別に記録を集計します。特にget_followers、search、mentions、ゲートpollingはread増加の原因になりやすいため、日次基準値と停止閾値を決めます。

コスト事故時は、まず自動機能または対象ゲートを止めます。調査のために同じ高額APIを繰り返すのではなく、usage log、D1 cache、Cron時刻、deployment差分を先に確認します。

手順

1. 基準値を作る

平常日のread/write、endpoint、gate、投稿本数を記録します。

2. 毎朝3点確認

前日総量、最大endpoint、最大gateを見ます。

3. 閾値で停止

急増時は自動機能または対象gateを止め、再実行を防ぎます。

4. 根因を切り分け

usage、cache miss、Cron、manual操作、deploymentを時系列で照合します。

完了条件

• 日別・endpoint別・gate別に増加原因を特定
• 調査で追加の高額APIを呼ばない
• 停止対象と影響が明確
• 平常値・警告値・停止値が決まる

注意: READMEの費用例は将来の料金を保証しません。最終的な請求・残高はX Developer Consoleの現在値と照合します。

Academy教材: X Growthとコストを管理する / Lesson 19-4

更新・テスト・障害対応を本番運用へ固定する

mainの更新差分、17 migration、Worker/UI/MCPの互換性を検証環境で確認してから反映します。

この工程のゴール: 自社変更と公式更新を分離し、test・typecheck・build・migration・rollback付きで安全に更新できる

X Harnessはmonorepo全体のbuild、typecheck、Vitestを持ち、DBはschemaと連番migrationで更新されます。Workerだけ、Adminだけ、MCPだけを更新するとAPIやテーブルの不一致が起きるため、commitとdeploymentの対応を記録します。

障害時はhealth、認証、route、D1、X API、Cron、画面の順に層を分けます。投稿やDMの失敗は外部反映済みの可能性があるため、自動再試行前にX側とD1のIDを確認します。

手順

1. 更新差分を読む

commit、CHANGELOG、migration、route、schema、UI、MCPの変更を分類します。

2. 検証環境へ適用

backup後にmigration、Worker、Adminの順序を確認し、test/buildを通します。

3. 一人E2E

read-only、予約、gate、LINE連携など変更範囲だけを検証します。

4. GO/NO-GO

rollback、監視、未解決、再送禁止を明記して本番承認を取ります。

完了条件

• 公式差分と自社変更を分類
• 未適用migrationと適用順が明確
• typecheck・test・buildが成功
• rollbackと再送禁止を含むGO/NO-GO資料がある

注意: D1 migrationは元に戻せない変更を含む場合があります。backupと互換性確認なしに本番へ直接適用しません。

Academy教材: X Growthとコストを管理する / Lesson 19-5

公式ソース

• X Harness / README.md — 無料収集の構成と注意
• X Harness / packages/mcp/src/scraper.ts — twitter-cli実行と出力解析
• X Harness / packages/mcp/src/tools/scrape.ts — 4つの無料収集ツール
• X Harness / packages/create-x-harness/src/steps/scraper-setup.ts — Cookie入力とローカル設定
• X Harness / skills/x-growth-discover/SKILL.md — 海外ネタ発見フロー
• X Harness / skills/x-growth-article/SKILL.md — 記事下書きフロー
• X Harness / skills/x-growth-video/SKILL.md — 動画引用投稿フロー
• X Harness / apps/web/src/app/growth/page.tsx — Growth承認画面
• X Harness / packages/mcp/src/tools/growth.ts — Growth保存MCP
• X Harness / apps/web/src/app/usage/page.tsx — 利用量ダッシュボード
• X Harness / apps/worker/src/routes/usage.ts — 利用量集計API
• X Harness / packages/db/src/usage.ts — usage logデータ
• X Harness / docs/manual/06-operations-cost.md — 事故例と運用ルール
• X Harness / apps/worker/src/services/engagement-gate.ts — 課金が発生するゲート処理
• X Harness / package.json — build、test、typecheck scripts
• X Harness / vitest.config.ts — test構成
• X Harness / packages/db/migrations/017-growth-articles.sql — 最新の連番migration例
• X Harness / CHANGELOG.md — 公式変更履歴
• X Harness / CONTRIBUTING.md — 開発・検証ルール

関連ガイド

• /x-harness-installation-guide/
• /x-harness-ai-operations/
• X自動化ツール比較