Threads API でブログ告知を自動化してみた｜公式ドキュメントで分からなかった5ヶ所

ブログ記事を公開したら、Threads に告知を1件投稿する。この作業を、AI（Claude Code）に書かせた小さなツールで自動化して、2026年8月から使っています。理由は単純で、手作業の告知は私には続かないからです。このブログは過去に2回、更新ごと止まった実績があります。

ツールは動きましたが、作る途中と使い始めてからで、合わせて5ヶ所で詰まりました。どれもエラー文言や画面から原因にたどり着けない種類のもので、詰まった時点で検索しても日本語の答えはほぼ見つかりませんでした。この記事は、その5ヶ所の症状と原因、対処の記録です。

最初は X で作るつもりで、設計まで終えていました。やめたのは、開発者登録の5ドルをチャージする直前です。

X の API は有料で、記事1本の告知に約0.215ドル、最低5ドルからのチャージが必要でした（2026年8月の検討時点）。加えて、このブログの X アカウントには凍結歴があります。フォロワー0では露出もほぼ見込めません。

一方の Threads は API が無料です（1日250件まで）。アカウントは登録済みで、フィードがおすすめ中心なので、フォロワーがいなくても投稿が表示される余地があります。決め手は「X を後回しにするコストがゼロ」だったことです。必要になったときに登録しても、料金条件は変わりません。

セットアップの全手順は書きません。公式ドキュメントを読めば分かる部分は、公式のほうが正確で新しいからです。ここに書くのは、公式を読んでも分からなかったところだけです。5つの詰まりは互いに独立なので、同じエラーにぶつかって検索で来た人は、該当の見出しだけ読んでください。画面の名称や仕様は 2026年8月時点のものです。

① Threads のコールバック URL が保存できない。エラーも出ない

Threads API のアプリ設定は、「コールバック URL」の欄だけでは保存できません。「アンインストール」「削除」も含めた3欄すべてを埋める必要があります。埋めていなくてもエラーは出ず、保存に失敗したことすら表示されません。3欄とも同じ URL で通ります。

私はコールバック URL だけを入れて保存し、設定が何度やっても反映されない状態で止まりました。「アンインストール」「削除」の2欄にも同じ URL（ブログのトップページ）を入れたら、あっさり保存されました。コールバックの受け口を実際に用意していなくても、自分のアカウントに投稿するだけの用途では問題ありませんでした。

もう1つ、細かい罠があります。URL を入力したら、ドロップダウンに出る候補をクリックして確定させる必要があります。タグのような表示に変われば入力扱いです。文字を打っただけで別の欄に移ると、その欄は未入力のままです。

② 「アプリIDが送信されませんでした」の原因は ID の取り違え

「認証できませんでした: リクエストと一緒にアプリIDが送信されませんでした」というエラーは、ID を送っていても出ます。Threads API に渡すのは、開発者ダッシュボード上部に出る「アプリID」ではありません。Threads ユースケース設定の中にある「Threads アプリID」です。

厄介なのは、この2つがどちらも16桁の数字で、見た目では区別できないことです。しかもエラー文言は、パラメータを空にしたときと同じです。値は送っているのに「送信されませんでした」と言われるため、ID 自体が別物だという原因へたどり着くまでに時間を食いました。

対処は「Threads アプリID」と、対になるシークレットへの差し替えです。ID だけを替えてもシークレットが古いままでは通りません。2つセットで差し替えます。

③ 1Password のサービスアカウントは、後から権限を変更できない

3つ目は Threads 本体ではなく、トークンの保存先にしている 1Password 側の詰まりです。ツールが 1Password から鍵を読み書きするための認証アカウント（サービスアカウント）は、作成した後から保管庫の追加も権限レベルの変更もできません。「あとで書き込み権限を足せばいい」という設計は、作成した時点で詰みます。

私は Threads のトークンを自動更新するために、読み取り専用で使っていた既存のサービスアカウントへ書き込み権限を足すつもりでした。できないと分かって設計を組み直し、当面は「新しいトークンを画面に表示して手で貼り替える」運用にしています。作業は1〜2ヶ月に1回、30秒ほどなので実害はありません。

API キーやトークンの置き場所を 1Password に集約する構成そのものと、そこで詰まった点は、AIにコードを書かせるとき、APIキーとパスワードをどこに置くか。1Passwordに集約した実践記録にまとめています。Threads に限らず、AI にツールを書かせる人全般に関わる話です。

④ リンクカードの画像は上下が切れる（比率 2.04:1）

Threads のリンクカードは約 402×197 ピクセル、比率 2.04:1 の横長です。1536×1024（3:2）のアイキャッチをそのまま渡すと、上下が 135 ピクセルずつ中央基準で切り落とされます。画像内の文字を上下 15% より内側に置いておけば欠けません。

1本目の告知では、文字の上端が画像の上から 90 ピクセルの位置にある画像を使い、タイトル文字の上側が欠けた状態で配信されました。カードの下に記事タイトルがテキストで出るため情報は伝わりますが、見た目は残念です。画像は作り直さず、次の画像から安全域を守る運用にしました。この比率は X（1.91:1）やはてなブックマークのカードとも近いので、上下 15% の帯を空ける習慣にしておけば、他のサービスでも共通で使えます。

⑤ 突然の「API access blocked」。9日ぶりの投稿で遮断

運用開始から9日後、2本目の告知を投稿しようとしたら、HTTP 400 の「API access blocked」で止まりました。投稿だけでなく、認証確認だけのコマンドも同じエラーです。端末で認証をやり直したら復旧しました。原因は特定できていません。

{"error":{"message":"API access blocked.","type":"OAuthException","code":200}}

この9日間、ツールのコードは1行も変えていません。トークンも取得から9日で、60日の有効期限には遠い状態でした。検索すると、開発者アプリの状態変化、アカウントの本人確認、トークンの失効あたりが既知の原因として出てきます。ただ、再認証で直ってしまったため、どれが原因だったのかは分からずじまいです。

分かっているのは、「まず再認証を試すのが早い」ということだけです。エラーは投稿を作る前の段階で止まっていたので、二重投稿の心配はありませんでした。

できたものと、いまの効果

ツールの中身は、Threads API に本文とリンクを送るだけの Python スクリプトです。外部ライブラリは使わず標準ライブラリだけで書き、テストを45件付けました。記事を公開したら告知の本文を書き、コマンドを1回実行すると、本文とリンクカード付きの投稿が出ます。カードには記事のアイキャッチが表示されます。

• 投稿に「via アプリ名」のような、自作アプリ経由だと分かるラベルは付きません。ログアウト状態（第三者と同じ見え方）で確認しました
• 投稿の削除 API は存在しますが、削除には別の権限が必要で、投稿用に取得したトークンでは消せません。テスト投稿は画面から手で消しました

肝心の集客効果は、まだ数字になっていません。これまでに3本の記事の告知で使いましたが、ブログへの流入が増えたと言える数字は出ていません（2026年8月時点）。それでも、告知を忘れる・面倒で後回しにするという一番ありがちな失敗は、仕組みごと消えました。

まとめ：詰まりどころは公式ドキュメントの外にある

振り返ると、時間を食った詰まりの多くは Threads 本体ではなく、その周辺（管理画面の作法と鍵の管理）にありました。AI にコードを書かせる人は、API キーとパスワードの置き場所を先に決めておくと、この種のツール作りがまとめて楽になります。

このブログは1円稼ぐまでの実験として、作った仕組みも結果の数字も隠さず公開しています。この告知ツールが集客の数字を動かせたかどうかは、続報で書きます。