The Harness ／公式情報・ツール比較

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

· 執筆: The Harness 編集部
THE HARNESS LAB
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

    公式ソース

    関連ガイド

    Academy会員はコピペ実行用プロンプトと演習を開くと、同じ手順をAIへ渡して実機で進められます。