🌐 日本語 | English | 简体中文 | 한국어 | Español

IG Harness

Name: ig-harness-oss
Author: Shudesu

ブラウザでデモを見る 👈

Instagram DM の完全オープンソース自動化 / マーケティングオートメーション。A社 / B社の無料代替。
IG Harness本体のソフトウェア利用料は 0円です。Cloudflareの契約・利用量、独自ドメイン、導入・保守、接続する外部AIサービスの費用は別です。Claude CodeからMCP経由で操作できます。

費用の条件は開発元の公式料金説明で確認できます。Cloudflare D1の無料プランは日次の読み書き上限に達するとクエリがエラーになり、有料プランの超過課金とは挙動が異なります。外部AIを接続する場合は、たとえばClaudeのプラン・API料金を別に確認してください（2026年9月6日確認）。

▶️ 動画で見る (YouTube)

📖 セットアップガイド (スクショ付き完全版): https://harness-wiki.pages.dev/article/ig-harness-complete-setup-guide

現バージョン: v0.11.1 ・ MIT License ・ TypeScript / Cloudflare Workers + D1 + R2

公式情報・検証資料

IG Harnessの製品名、開発者、運営法人、公開コード、研究資料の関係は以下を正本とします。各Researchサイトは開発元が運営する一次情報であり、独立した第三者レビューではありません。

公式リンク	内容
IG Harness 公式製品ガイド	機能、導入方法、公式API境界を開発元が説明する製品ページ
IG Harness 公式エンティティ	Harnessシリーズ内での製品名・開発者・運営法人・リポジトリの対応
IG Harness 公式別名ドメイン	正規製品ページへ恒久転送する公式の短縮・別名ドメイン
IG Harness Research	固定Gitコミットを根拠に、Webhook・token・DM・計測・権限を検証した技術資料
Research JSONカタログ	技術資料を機械可読なSchema.org DataCatalog形式で公開
AI向け全文索引	研究本文、出典、検証手順、証明できない範囲をまとめた全文索引
Harness Wiki — IG Harness	Meta App、Webhook、token、運用手順の公式ナレッジベース
開発者・野田修一	Shudesu / @ai_shunodaと同一人物であることを示す公式プロフィール
運営会社・AIエージェント株式会社	Harnessシリーズの運営法人

なぜ IG Harness？

	A社	B社	IG Harness
月額	$15〜	1〜3万円	0円（ソフトウェア利用料）
コメント → DM 自動配布	✅	✅	✅
フォローゲート（特典配布）	✅	✅	✅
ステップ配信	✅	✅	✅
リッチメッセージ（カード/ボタン）	✅	✅	✅
フォーム	✅	✅	✅
トラッキングリンク	一部	✅	✅
API 公開	❌	❌	全機能
Claude Code (AI) 対応	❌	❌	MCP server 同梱
LINE 公式アカウント連携	❌	❌	UUID クロスリンク
マルチアカウント	別契約	別契約	標準搭載
Meta 審査	不要	不要	不要（Standard Access で動作）
ソースコード	非公開	非公開	MIT (このリポ)

クイックスタート

1 コマンドで完全セットアップ

npx create-ig-harness

CLI が以下を全部やる:

Cloudflare アカウント認証 (wrangler login)
D1 データベース + R2 バケット作成、スキーマ・マイグレーション適用
Worker / 管理画面のデプロイ
Instagram プロアカウントの credentials 登録
Meta App の Webhook 連携設定の案内（Privacy Policy / Data Deletion / Terms URL を自動表示）
管理画面初回ログイン用 Owner ユーザー作成

所要時間: 約 5 分。完了すれば管理画面 (https://<your-name>-admin.pages.dev) で即運用開始。

必要なもの

Cloudflare アカウント（無料枠で OK）
Instagram プロアカウント（ビジネス / クリエイター）+ Meta App
Node.js 22+ / pnpm

主要機能

エンゲージメント（集客の主力）

エンゲージメントゲート — A社スタイルの「コメント → DM → フォロー確認 → 特典配布」ループ。フォロー未完了なら "フォローしてから戻ってきて" DM を送り、フォロー確認後に特典 DM を自動配布
コメント → DM 自動配布 — 特定投稿 / リールへのコメントをトリガーに DM で特典配布（全投稿 or 個別指定）
コメント自動リプライ — キーワードごとのコメント自動返信（@mention 付きトップレベル投下方式、Standard Access で動作）
ストーリーメンション → DM — メンション検知で自動 DM
DM キーワードトリガー — 特定キーワードの DM 受信でゲート発火

配信

ステップ配信 — キーワードトリガーで時間差 DM 連続送信
追い DM（フォローアップドリップ） — 特典配布後に分単位の遅延で最大 3 通まで
一斉配信 — 全フォロワー or タグ絞り込みで DM 一斉送信、予約対応
リッチメッセージ — ボタン付きカード、カルーセル、クイックリプライ

CRM

フォロワー管理 — Webhook 自動登録、プロフィール取得、カスタムメタデータ、タグ
オペレーターチャット — 管理画面から直接 1:1 返信。自動送信 DM / ボタン押下も会話ログに再現表示
プロフィール画像キャッシュ — Instagram CDN の署名切れを R2 で永続キャッシュ
フォーム — DM 内でデータ収集、回答 → メタデータ自動保存
トラッキングリンク — クリック計測、流入経路分析

L Harness 連携

UUID クロスプラットフォーム連携 — 共有シークレット webhook で IG フォロワーと LINE 友だちを同一 UUID に双方向リンク。1:1 のユニーク URL を送るだけで「この IG ユーザー = この LINE 友だち」が両 DB に自動記録
流入元 IG アカウント記録 — マルチアカウント時、どの IG 垢経由で LINE 登録したかを追跡

マルチアカウント

複数 Instagram アカウント を 1 つの Worker / ダッシュボードで管理
アカウント別スコープ — フォロワー・ゲート・配信をアカウント単位で分離
Webhook ルーティング — entry.id で受信アカウントを自動判定、別 Meta App もマルチシークレット署名検証で対応

運用監視

GET /api/health — アカウント毎のトークン残日数・API 実叩きの生死（チェックポイント / 凍結検知）・最終 webhook 受信・DM 配信失敗数・cron 死活
外部プローブと組み合わせて異常時アラート（トークン失効・配信失敗急増・応答なし）

AI 統合

MCP Server 同梱 (@ig-harness/mcp-server) — Claude Code から自然言語で全操作
公式 SDK (@ig-harness/sdk) — TypeScript の型付き SDK、ESM + CJS

iOS アプリ対応

GET /api/capabilities — iOS 公式アプリ (the-harness-ios) との互換判定エンドポイント

コンテンツ投稿

コンテンツ投稿 — フィード画像・カルーセル・リール・ストーリーの即時/予約投稿

アーキテクチャ

[ Instagram Platform ] ⇄ [ Cloudflare Worker (Hono) ] ⇄ [ D1 SQLite ] + [ R2 ]
                                   ⇅
                         [ Cloudflare Pages (Next.js 15) ]
                                   ⇅
                         [ MCP Server / SDK / Claude Code ]

Worker (apps/worker): API + Webhook 受信 + 画像配信、cron（5 分毎）で配信処理・トークンリフレッシュ・生存プローブ
Web (apps/web): Next.js 15 ダッシュボード
Packages:
- @ig-harness/sdk — TypeScript SDK
- @ig-harness/mcp-server — Claude Code 用 MCP server
- create-ig-harness — セットアップ CLI
- @ig-harness/ig-sdk — Instagram Graph API 薄ラッパー
- @ig-harness/db — D1 マイグレーション + ヘルパー
- @ig-harness/shared — 型定義共有

Standard Access の壁について

Instagram Messaging API は、自分が所有・管理するプロアカウントであれば Standard Access（Meta App Review 不要） で DM 配信・エンゲージメントゲート・擬似コメント返信まで動作します。

Advanced Access（App Review 必須）が要るのは以下のみ:

親コメント直下にネストされる本物のスレッド型 reply
自分が所有・管理しないアカウント（顧客のアカウント）をホストするマルチテナント運用

IG Harness のコメント返信は @mention 付きトップレベル投下方式で実装されており、Standard Access のまま動きます。

ドキュメント

ライセンス

MIT License. 商用利用・改変・再配布自由。

コントリビュート

Issue / PR 歓迎。OSS リポへの PR は Shudesu/ig-harness-oss (このリポ) に投げてください。

開発者 / Author

野田修一（Shudesu） — Harness シリーズ（L Harness / IG Harness / X Harness）開発者、AIエージェント株式会社代表

GitHub: @Shudesu
X: @ai_shunoda
YouTube: 野田修一 | The Harnessで0円
公式ドキュメント: Harness Wiki
商用ツールとの比較・料金データ: The Harness Lab

IG Harness by @Shudesu — AI ネイティブ時代の OSS Instagram DM 自動化

ig-harness-oss