LINE / 公式リポジトリの日本語解説
L Harness OSS版を、コードを読まずに理解する
L Harnessは、LINE公式アカウントの配信・顧客管理・自動化をまとめて扱う、オープンソースのソフトウェアです。公式リポジトリに書かれている内容を、事業者の目線で順番に並べ直しました。
- ソフトウェア利用料
- 0円(MIT License)
- 別にかかる費用
- LINEの配信料金、Cloudflareの利用料、独自ドメイン、導入・保守、外部AI
- 動く場所
- 自分のCloudflareアカウント(Workers+D1)
- 始め方
- コマンド1行のセットアップ、または構築不要のCloud版
L Harnessで何ができるか
配信
友だち追加からの分単位のステップ配信、全員・タグ・セグメント別の一斉配信、セミナー3日前・1日前・当日のようなリマインダー。名前を差し込むテンプレートも使えます。
顧客管理
友だちの自動登録、タグ、行動にもとづくスコア、管理画面からの1対1の返信。未返信の会話を放置時間の順に一覧できます。
フォームと予約
LINEの中で完結するフォームと、Googleカレンダー連携の予約。ウェビナーのフォーム送信後に、その場で空き日時を選んでもらう流れも組めます。
自動化
7種類のきっかけと6種類の動作を組み合わせるIF-THENルール、キーワードの自動返信、Stripe・Slackなど外部サービスとのWebhook連携。
複数アカウント
複数のLINE公式アカウントを1つの管理画面で扱えます。アカウントの停止(BAN)を検知したときに、次のアカウントへ友だちを移すプール機能があります。
AIから操作
Claude Codeから自然な言葉で操作するためのMCPサーバーが同梱されています。メッセージ送信のツールは、READMEで「要ユーザー確認」と案内されています。
どんな人に向いているか
- LINE公式アカウントで、配信と顧客管理を続けている事業者
- 月額制の配信ツールの費用を見直したい人
- 顧客データを自分の契約するサーバー(Cloudflare)に置きたい人
- AIに配信の下書きや集計を手伝わせたい人
先に知っておきたいこと
- コマンドを1行も実行したくない人は、サーバー構築が不要なCloud版(Googleでログインして始める形式)が向いています。
- Cloudflareの契約・利用量、LINEの配信料金は、ソフトウェアとは別に自分で負担します。
押して進める
自分の環境に入れる6ステップ
-
必要なものをそろえる
Node.js 22以上とGitが入ったPC、自分のCloudflareアカウント、自分のLINE公式アカウントを用意します。
- Cloudflareでは途中でR2の有効化と支払い情報の登録が必要です。
- LINE側では、Messaging APIチャネル・同じプロバイダーのLINE Loginチャネル・LIFFアプリを案内に沿って設定します。
-
コマンドを1行実行する
ターミナルに「npx --yes create-line-harness@latest」を貼り付けて実行します。
- ここから先は、画面に出る質問に答えながら進みます。
-
ログインとLINE情報の入力
案内に沿ってCloudflareにログインし、プロジェクト名、LINEのチャネル情報、LIFF IDを入力します。
- それぞれの値をどこで確認するかは、実行画面に表示されます。
-
あとはCLIが進める
データベースの作成、アプリの配置、管理画面に初めてログインするためのユーザー作成は、CLIが自動で進めます。
- かかる時間は、アカウント作成やLINE側の設定の状況によって変わります。
-
表示されたURLをLINEに設定する
完了画面に出るWebhook URL・LINE LoginのCallback URL・LIFFのエンドポイントURLを、LINE側の設定画面に登録します。
- URLを貼る場所は3か所です。Webhook URLはMessaging APIチャネルのWebhook設定、Callback URLはLINE LoginチャネルのCallback URL、LIFFのエンドポイントURLはLIFFアプリの設定に貼ります。
-
管理画面で動作を確かめる
表示された管理画面のURLを開き、友だち登録とメッセージの送受信ができることを確認します。
- 最初は自分のLINEだけで試し、配信対象を広げるのは確認が終わってからにします。
アップデートのしかた
新しい版が出たら、まず「公式の構成のまま使っているか」で方法が分かれます。
- 古い版からの最初の1回は、管理画面の更新ボタンではなく「npx create-line-harness@latest update」で更新します。同じコマンドは再実行できます。
- 実行前に、Cloudflare D1のデータをバックアップしておくことが推奨されています。
- 管理画面の自動更新は、公式リリースと同じ構成の環境だけが対象です。コードを書き換えている場合や、自前の仕組みで配置している場合は手動の手順で更新します。
- バージョンが「v0.0.0-dev」と出る環境では、更新コマンドが公式リリースへの引き上げを提案します。コードを書き換えている場合は承認しません(書き換えた部分が上書きされるため)。
- 更新後は、管理画面のバージョン表示を確かめ、実際に使っているフォーム・予約・ウェビナーの入口を1件ずつ開きます。
どの版で何が変わったかは、このサイトの更新履歴で日本語でまとめています。
プラグインで機能を足す(β)
配信ルール・自動処理・外部サービス連携を、本体とは別の場所に切り出して足す仕組みです。本体を更新しても、自分で書いた処理が上書きされにくくなります。
- 管理画面の「プラグインマーケット」から、拡張と開発用の資料を探せます。β版は導入ガイド付きのカタログで、プラグインは1つずつ自分でセットアップします。
- 最初の公式プラグインは、条件に合う友だちにタグを付ける「条件タグ付け」です。
- 自作する場合は、本体のフォルダで「pnpm plugin:create ../my-plugin」を実行してひな形を作ります(Node.js 22以上)。
- 独自の処理が上書きされないことと、本体の新しい版でも動くこと(API互換性)は別の話です。本体を更新するときは、テスト環境で接続を確かめます。
- 作ったプラグインをマーケットに載せたい場合は、公開リポジトリのIssueにある「掲載申請」のフォームから申し込みます。GitHubへのログインが必要で、申請は公開されるため、APIキーや顧客の情報は書きません。申請先は、このページ最後の参照リンク(公開リポジトリ)から開けます。
紹介・アフィリエイトの計測
紹介してくれる人(アフィリエイター)ごとに、クリックから友だち追加、成果までを記録する機能が入っています。
- 紹介者はLINEの中の画面から自分で登録し、媒体ごとの紹介リンクを発行します。1人あたり20本までです。
- 成果は、友だち追加の時点から90日以内にさかのぼって、最後にクリックされた紹介リンクの持ち主に結びつけます。
- 紹介者が自分のリンクを自分で踏んでも、成果には数えません。
- 成果が出た時点の報酬率で記録するため、あとで率を変えても過去の集計は変わりません。
- 同じ人が複数のアカウントで登録したとみられる場合は、管理画面に注意の印が付きます。成果が確定すると、紹介者にLINEで通知が届きます。
よくある質問
本当に無料で使えますか?
L Harness本体のソフトウェア利用料は0円です。ただし、LINE公式アカウントの配信料金、Cloudflareの契約・利用量、独自ドメイン、導入や保守を頼む場合の費用、接続する外部AIの費用は別にかかります。
プログラミングができなくても導入できますか?
セルフホストではターミナルでコマンドを1行実行し、画面の質問に答えて進めます。PCへのインストールやサーバー構築を省きたい場合は、Googleでログインして始めるCloud版があります。
今使っているLINE公式アカウントで使えますか?
自分のLINE公式アカウントに、Messaging APIチャネル・LINE Loginチャネル・LIFFアプリを設定して接続します。ほかの配信ツールから移る場合のデータの扱いは、移行の解説記事で確認してください。
アップデートはどうすればいいですか?
古い版からの最初の1回は「npx create-line-harness@latest update」で更新します。実行前のバックアップが推奨されています。詳しくはこのページの「アップデートのしかた」にまとめています。
不具合を見つけたらどうすればいいですか?
公開リポジトリのIssueで、同じ不具合が報告されていないか検索できます。報告するときは、APIキーや顧客の情報を書かないでください。機密情報を含む報告は、公開されているセキュリティ方針に沿って扱われます。
AIに勝手にメッセージを送られませんか?
同梱のMCPサーバーには、一斉配信やメッセージ送信のツールも含まれます。公式READMEでは、送信系のツールは「要ユーザー確認」と案内されています。AIに渡すAPIキーの権限を絞り、最初は読み取りと下書きだけを任せる使い方から始めると安全です。
次に読む1本
IG Harnessの解説 →
LINEに集めたお客様の入口を増やすなら、次はInstagramです。コメントからDMで特典を渡し、LINEへつなぐ仕組みを解説しています。
このページの特典(無料)
コピペで使える LINEメッセージ文例20
友だち追加のお礼、予約の前日のお知らせ、来店のお礼など、お店のLINEでよく使う20通。[ ]をお店の言葉に変えて送るだけです。
- あいさつ(友だち追加のお礼・自己紹介)
- 予約の確認・前日と当日のお知らせ
- 来店のお礼・口コミのお願い・久しぶりの方へ
- 新メニュー・お休み・空き枠のお知らせ
- すぐ返せないときなど、困ったときの返事
友だち追加すると、この特典がLINEで届きます。配信が不要になったら、いつでもブロックで止められます。
- 友だち追加ありがとうございます![店名]です。
- 明日[時間]から、ご予約をいただいています。
- 本日はご来店ありがとうございました!
- 【空きが出ました】[日付][時間]に1枠…