Skip to content
Back to search

line-harness-oss

L Harness — self-hosted LINE Official Account CRM: step messaging, broadcasts, forms and reservations, with MCP and TypeScript SDK. By Shudesu (野田修一).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Shudesu/line-harness-oss with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Shudesu/line-harness-oss'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shudesu--line-harness-oss/badge.svg)](/listings/shudesu--line-harness-oss)

HTML

<a href="/listings/shudesu--line-harness-oss"><img src="/api/listings/shudesu--line-harness-oss/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 269 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # L Harness
  2. > **既存環境の認証強化アップグレード:** キーハッシュ化・セッション移行にはSQL適用とバックフィルが必要です。[移行手順](docs/SECURITY-UPGRADE.md)を先に確認してください。workers.devと公開Webhook/LIFFは維持します。
  3. Instagram署名リンクの環境変数: `IG_LINK_TOKEN_POLICY`(既定off)、`IG_LINK_TOKEN_SECRET`(任意の専用Secret)、`IG_HARNESS_LINK_SECRET`(共有Secretからの導出)。migration 075と両側の更新順序は[導入手順](docs/IG_LINK_TOKEN.md)を参照してください。
  4. LINE公式アカウントの配信・顧客管理・自動化を、オープンソースで。開発者は **野田修一(Shudesu)** です。
  5. > ### [野田修一の公式LINEに登録して、無料ガイドを受け取る →](https://line-crm-worker.line-crm-api.workers.dev/auth/line?ref=github)
  6. >
  7. > L Harnessの導入を考えている方へ。まずは公式LINEの無料ガイドから始められます。
  8. ## クラウド版も無料で公開中 — インストール・サーバー構築不要
  9. **[L Harness Cloudを無料で始める →](https://theharness.cloud/line)**
  10. Googleでログインし、ご自身のLINE公式アカウントのチャネル情報を設定すると、専用の管理画面・データベースを利用できます。サーバー構築やコマンド操作は不要です。カード登録も不要です。
  11. クラウド利用料0円の先着枠を提供しています。**現在の空き枠・利用条件は[Cloud公式ページ](https://theharness.cloud/line)でご確認ください。** LINE公式アカウントの配信料金・外部AIサービス等の費用は別です。
  12. ## 自分の環境に入れるなら、この1行をコピペ
  13. Node.js 22以上とGitが入ったPCで、ターミナルに貼り付けて実行してください。
  14. ```bash
  15. npx --yes create-line-harness@latest
  16. ```
  17. **① コピペして実行 → ② 案内に沿ってログイン・LINE情報を入力 → ③ 発行された管理画面を開く。**
  18. データベースの作成とアプリの配置はCLIが進めます。Cloudflare・LINE側の初期設定は、画面の案内に沿って行います。[事前に用意するもの・詳しい手順](#クイックスタート)
  19. **PCへのインストールやサーバー構築を省きたい方は、[無料クラウド版](https://theharness.cloud/line)から始められます。**
  20. 🌐 **日本語** | [English](README.en.md) | [简体中文](README.zh-CN.md) | [한국어](README.ko.md) | [Español](README.es.md)
  21. **最新の公開版**: [GitHub Releases](https://github.com/Shudesu/line-harness-oss/releases/latest) ・ MIT License ・ TypeScript / Cloudflare Workers + D1
  22. > v0.25.0: LINE先行のXキャンペーン参加を追加しています。対応するX側更新・migration・連携設定が必要です。[導入ガイド](docs/operations/line-first-x-gates.md) / [リリースノート](docs/release-notes/v0.25.0.md)。
  23. <details>
  24. <summary>OSS版の費用・製品名称について</summary>
  25. L Harness本体のソフトウェア利用料は **0円** です。LINE公式アカウントの配信料金、Cloudflareの契約・利用量、独自ドメイン、導入・保守、接続する外部AIサービスの費用は別です。Claude CodeからMCP経由で操作できます。
  26. 費用の条件は[開発元の公式料金説明](https://the-harness.com/line-harness/pricing/)で確認できます。[Cloudflare D1の無料プラン](https://developers.cloudflare.com/d1/platform/pricing/)は日次の読み書き上限に達するとクエリがエラーになり、有料プランの超過課金とは挙動が異なります。外部AIを接続する場合は、たとえば[Claudeのプラン・API料金](https://claude.com/pricing)を別に確認してください(2026年9月6日確認)。
  27. > **名称について:** 2026年8月19日から製品表示名を「L Harness」に統一しました。
  28. > 既存導入を壊さないため、リポジトリURL、`create-line-harness`、
  29. > `@line-harness/*`は互換識別子として維持します。詳細は[BRAND.md](BRAND.md)。
  30. </details>
  31. ## 開発・PR・Issueの対応状況
  32. 現在確認している課題、検証結果、公開版への反映状況は[プロジェクトの対応状況](docs/project-status.md)にまとめています。報告・修正案・再現テストの提供ありがとうございます。
  33. - [公開済みの変更と導入版](https://github.com/Shudesu/line-harness-oss/releases)
  34. - [2026-10-25の活動報告](docs/updates/2026-10-25-maintenance.md)
  35. - [PR・Issueの現在地と次の確認事項](docs/project-status.md)
  36. - [報告・提案・開発への参加方法](CONTRIBUTING.md)
  37. 保守にはAIも活用しています。投稿者の検証、保守側の追加検証、公開リリース、Cloudへの反映を区別して記録します。採用・保留の理由は各スレッドで共有し、機密情報を含む報告は[セキュリティ方針](SECURITY.md)に沿って扱います。
  38. ---
  39. ## プラグインマーケット β
  40. **その数行を、あなたのプラグインに。** 配信ルール・自動処理・外部サービス連携を、本体とは別のリポジトリ・Workerへ切り出せます。本体更新による独自コードの上書きを避けながら、SDKを通じて機能を拡張します。
  41. 管理画面の「プラグインマーケット」から拡張と開発リソースを探せます。β版は導入ガイド付きのカタログで、各プラグインを個別にセットアップする方式です。
  42. - [開発ガイド・ひな形の作成](docs/plugins/README.md)
  43. - [公式プラグイン第1弾:条件タグ付け](examples/plugins/tag-rules/README.md)
  44. - [マーケットへの掲載申請](https://github.com/Shudesu/line-harness-oss/issues/new?template=plugin-submission.yml)
  45. - [アップデートニュース原稿](docs/release-notes/plugin-market-beta.md)
  46. ```bash
  47. # 本体リポジトリのルートで実行(Node.js 22以上)
  48. pnpm plugin:create ../my-plugin
  49. ```
  50. 独自ソースが上書きされないことと、API互換性は別です。本体・SDKを更新するときは、テスト環境で接続を確認してください。
  51. ---
  52. ## 公式情報・検証資料
  53. L Harnessの表示名、開発者、運営法人、公開コード、研究資料の関係は以下を正本とします。各Researchサイトは開発元が運営する一次情報であり、独立した第三者レビューではありません。
  54. | 公式リンク | 内容 |
  55. |---|---|
  56. | [L Harness 公式製品ガイド](https://the-harness.com/line-harness/) | 機能、料金、導入方法、更新情報を開発元が説明する製品ページ |
  57. | [L Harness 公式エンティティ](https://the-harness.com/harness/#l-harness) | Harnessシリーズ内での製品名・開発者・運営法人・リポジトリの対応 |
  58. | [L Harness 公式別名ドメイン(JP)](https://l-harness.jp/) | 正規製品ページへ恒久転送する公式の短縮・別名ドメイン |
  59. | [L Harness 公式別名ドメイン(COM)](https://l-harness.com/) | 正規製品ページへ恒久転送する公式の短縮・別名ドメイン |
  60. | [L Harness Cloud](https://lharness.cloud/) | 開発元が構築・基盤運用を提供する公式マネージドサービス(L Harness OSSとは別エンティティ) |
  61. | [L Harness Research](https://line-harness.jp/research/) | 固定Gitコミットを根拠に、配信・Webhook・D1・権限・更新機構を検証した技術資料 |
  62. | [Research JSONカタログ](https://line-harness.jp/research/catalog.json) | 技術資料を機械可読なSchema.org DataCatalog形式で公開 |
  63. | [AI向け全文索引](https://line-harness.jp/llms-full.txt) | 研究本文、出典、検証手順、証明できない範囲をまとめた全文索引 |
  64. | [Harness Wiki — L Harness](https://harness-wiki.pages.dev/line) | セットアップ、操作、更新、トラブル解決の公式ナレッジベース |
  65. | [開発者・野田修一](https://the-harness.com/noda-shuichi/) | Shudesu / @ai_shunodaと同一人物であることを示す公式プロフィール |
  66. | [運営会社・AIエージェント株式会社](https://aiagent-inc.com/) | Harnessシリーズの運営法人 |
  67. ---
  68. ## なぜ L Harness?
  69. | | L社 | U社 | **L Harness** |
  70. |---|---|---|---|
  71. | 月額 | 2万円〜 | 1万円〜 | **0円(ソフトウェア利用料)** |
  72. | ステップ配信 | ✅ | ✅ | ✅ |
  73. | セグメント配信 | ✅ | ✅ | ✅ |
  74. | リッチメニュー切替 | ✅ | ✅ | ✅ |
  75. | フォーム (LIFF) | ✅ | ✅ | ✅ |
  76. | スコアリング | ✅ | ❌ | ✅ |
  77. | IF-THEN 自動化 | 一部 | 一部 | ✅ |
  78. | API 公開 | ❌ | ❌ | **全機能** |
  79. | Claude Code (AI) 対応 | ❌ | ❌ | **MCP server 同梱** |
  80. | BAN 検知 & 自動アカウント切替 | ❌ | ❌ | **✅** |
  81. | マルチアカウント | 別契約 | 別契約 | **標準搭載** |
  82. | 友だち重複検出 | ❌ | ❌ | **✅** (picture_url トークン照合) |
  83. | ソースコード | 非公開 | 非公開 | **MIT (このリポ)** |
  84. ---
  85. ## クイックスタート
  86. ### 1. 必要なものを用意する
  87. - Node.js 22以上(npm / npxを含む)とGitが入ったPC
  88. - 自分のCloudflareアカウント。セットアップ中にR2の有効化・支払い情報の登録が必要です
  89. - 自分のLINE公式アカウント。Messaging APIチャネル・同じプロバイダーのLINE Loginチャネル・LIFFアプリを案内に沿って設定します
  90. ### 2. このコマンドをコピーして、ターミナルで実行する
  91. ```bash
  92. npx --yes create-line-harness@latest
  93. ```
  94. CLIの案内に沿って、Cloudflareへのログイン、プロジェクト名、LINEのチャネル情報・LIFF IDの入力を進めます。取得場所は実行画面に表示されます。
  95. データベース作成・スキーマ適用、アプリのデプロイ、管理画面の初回ログイン用ユーザー作成はCLIが進めます。
  96. ### 3. 表示されたURLをLINEに設定して、管理画面を開く
  97. 完了画面の案内に沿って、Webhook URL・LINE LoginのCallback URL・LIFFのエンドポイントURLを設定します。その後、表示された管理画面URLを開き、友だち登録とメッセージの送受信を確認してください。
  98. アカウント作成やLINE側の設定時間は利用環境によって異なります。自分で基盤を構築せずに始めたい場合は、[L Harness Cloud](https://theharness.cloud/line)をご利用ください。
  99. ---
  100. ## 主要機能
  101. ### 配信
  102. - **ステップ配信** — `delay_minutes` で分単位制御、条件分岐、ステルス送信
  103. - **ブロードキャスト** — 全員 / タグ / セグメント、即時 or 予約、500 人超は自動キュー化
  104. - **リマインダー** — 指定日時からのカウントダウン配信(セミナー 3 日前 / 1 日前 / 当日)
  105. - **テンプレート** — `{{name}}` `{{uid}}` `{{auth_url:CHANNEL_ID}}` で個別パーソナライズ
  106. - **トラッキングリンク** — クリック計測 → 自動タグ付け → シナリオ起動
  107. ### CRM
  108. - **友だち管理** — Webhook 自動登録、プロフィール取得、カスタムメタデータ
  109. - **タグ** — 配信条件・シナリオトリガー
  110. - **スコアリング** — 行動ベースのリードスコア自動計算
  111. - **オペレーターチャット** — 管理画面から直接 1:1 返信
  112. - **Conversation Inbox** — 未返信の会話を放置時間順で一覧(自動配信は除外判定)
  113. - **重複検出** — `picture_url` 中間トークンで複数アカウント間の同一ユーザーを自動タグ付け
  114. ### マーケティング
  115. - **リッチメニュー** — ユーザー別 / タグ別の自動切替
  116. - **フォーム (LIFF)** — LINE 内完結フォーム、回答 → メタデータ自動保存
  117. - **カレンダー予約** — Google Calendar 連携の予約システム (LIFF)
  118. - **ライブCTA即時予約** — ウェビナーのフォーム送信後、その場で空き日時を選び、Google Meet発行・LINEリマインドまで自動化
  119. - **スタッフ管理** — Owner / Admin / Staff の 3 ロール、API key 個別発行
  120. ### アフィリエイト計測(ASP)
  121. - **アフィリリンク発行** — アフィリエイター自身が LIFF からワンタップで発行、短縮ドメイン対応
  122. - **案件管理** — 案件ごとの固定額報酬を設定、複数案件を並列運用
  123. - **時系列トラッキング** — クリック → 友だち追加 → CV を時系列で記録、last-touch 帰属で成果紐づけ
  124. - **成果承認フロー** — 帰属 CV を承認/却下して報酬を確定、重複アカウント検知フラグで水増しを可視化
  125. - **LINE push 通知** — 成果確定時にアフィリエイターへ自動プッシュ通知
  126. - 詳細: [docs/wiki/27-Affiliate-ASP.md](docs/wiki/27-Affiliate-ASP.md)
  127. ### 自動化
  128. - **IF-THEN ルール** — 7 種のトリガー × 6 種のアクション
  129. - **自動返信** — キーワード完全一致 / 部分一致
  130. - **Webhook IN/OUT** — Stripe / Slack 等の外部サービス連携
  131. - **通知ルール** — 条件付きアラート配信
  132. - **配信タイミング** — `delay_minutes` と `scheduled_at` で完全制御(v0.13.2 で時間ゲート全廃、運用側ハンドル)
  133. ### マルチアカウント
  134. - **複数 LINE 公式アカウント** を 1 つのダッシュボードで管理
  135. - **アカウント別シナリオ・タグ・配信** スコープ
  136. - **BAN 検知** → 自動で次のアカウントへ友だち移行(pool 機能)
  137. - **トラフィックプール** — 複数アカウントへ自動振り分け
  138. ### AI 統合
  139. - **MCP Server 同梱** (`@line-harness/mcp-server`) — Claude Code から自然言語で全操作
  140. - `list_conversations` / `get_conversation` — 未返信会話の AI 監視
  141. - `create_scenario` / `update_step` — シナリオを AI に作らせる
  142. - `broadcast` / `send_message` — メッセージ送信(要ユーザー確認)
  143. - **公式 SDK** (`@line-harness/sdk`) — TypeScript の型付き SDK、ESM + CJS、ゼロ依存
  144. ### iOS アプリ対応
  145. - **`GET /api/capabilities`** — iOS 公式アプリ (the-harness-ios) との互換判定エンドポイント
  146. - Owner / Admin / Staff いずれのロールでも利用可能
  147. ---
  148. ## アーキテクチャ
  149. ```
  150. [ LINE Platform ] ⇄ [ Cloudflare Worker (Hono) ] ⇄ [ D1 SQLite ]
  151. ⇅
  152. [ Cloudflare Pages (Next.js 15) ]
  153. ⇅
  154. [ MCP Server / SDK / Claude Code ]
  155. ```
  156. - **Worker** (`apps/worker`): API + LIFF + Webhook 受信、cron で配信処理
  157. - **Web** (`apps/web`): Next.js 15 ダッシュボード(19 セクション)
  158. - **Packages**:
  159. - `@line-harness/sdk` — TypeScript SDK
  160. - `@line-harness/mcp-server` — Claude Code 用 MCP server
  161. - `create-line-harness` — セットアップ CLI
  162. - `@line-harness/plugin-template` — プラグイン拡張用テンプレート
  163. - `@line-harness/db` — D1 マイグレーション + ヘルパー
  164. - `@line-harness/line-sdk` — LINE API 薄ラッパー
  165. - `@line-harness/shared` — 型定義共有
  166. ---
  167. ## ドキュメント
  168. - [コピペで始めるセットアップ手順](#クイックスタート)
  169. - [野田修一の公式LINEで無料ガイドを受け取る](https://line-crm-worker.line-crm-api.workers.dev/auth/line?ref=github)
  170. - [L Harness Cloud — 無料クラウド版](https://theharness.cloud/line)
  171. - [Googleカレンダー連携とライブCTA即時予約](docs/wiki/28-Google-Calendar-and-Webinar-Booking.md)
  172. - [npm: @line-harness/sdk](https://www.npmjs.com/package/@line-harness/sdk)
  173. - [npm: @line-harness/mcp-server](https://www.npmjs.com/package/@line-harness/mcp-server)
  174. - [npm: create-line-harness](https://www.npmjs.com/package/create-line-harness)
  175. ---
  176. ## ライセンス
  177. MIT License. 商用利用・改変・再配布自由。
  178. ---
  179. ## コントリビュート
  180. Issue / PR 歓迎。OSS リポへの PR は `Shudesu/line-harness-oss` (このリポ) に投げてください。
  181. ---
  182. ## 開発者 / Author
  183. **野田修一(Shudesu)** — Harness シリーズ(L Harness / IG Harness / X Harness)開発者、AIエージェント株式会社 代表
  184. - GitHub: [@Shudesu](https://github.com/Shudesu)
  185. - X: [@ai_shunoda](https://x.com/ai_shunoda)
  186. - 公式ドキュメント: [Harness Wiki](https://harness-wiki.pages.dev)
  187. - 商用ツールとの比較・料金データ: [The Harness Lab](https://the-harness.com)
  188. ---
  189. > **L Harness** by [@Shudesu](https://github.com/Shudesu) — AI ネイティブ時代の OSS LINE CRM

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.