Hooklayer

Hooklayer MCP

AI エージェント向けのバイラルコンテンツ分析ツールです。 Hooklayer MCP サーバーを Claude Desktop、Cursor、n8n、または任意の HTTP MCP クライアントに追加すると、TikTok、Instagram、YouTube のショート動画コンテンツ向けに、クリエイターの分析、キーワードによる動画検索、バイラルテンプレートや上昇中のトレンドの発見、フックのスコア評価と書き換え、バイラル動画のリミックス、クリエイターの話し方との照合、下書きのバイラル性予測、ブランドのブリーフから撮影可能なクリエイティブ設計図への変換、保存したウォッチと過去のスナップショットによるクリエイターの継続的なモニタリングを行う12個のツールをエージェントが利用できます。

12 tools · structured JSON · non-destructive creator monitoring · no external social-platform edits or deletes

v1.1.0（2026-05-14）： エビデンスレイヤーをリリースしました。すべてのスコアに、根拠を引用するsignals[]、反実仮想のwould_fail_because、健全性を示すqualityフィールドが含まれます。predict_viralityは独立した敵対的チェックを実行します。analyze_account.recommended_chainの各ステップに、confidence、cost、権限分類を示すaction_class、expected_outputが追加されました。リリースの詳細はCHANGELOG.mdをご覧ください。

---

🚀 クイックインストール

Claude Desktop

Claude Desktopはリモート HTTP MCP サーバーを標準ではサポートしていないため、mcp-remoteブリッジが必要です。インストール方法は2つあります。

オプション1 — カスタムコネクター（最も簡単。設定ファイルの編集は不要）

Claudeのウェブ／デスクトップ UI で、Settings → Connectors → Add custom connector → この URL を貼り付けます：

https://hooklayer.dev/api/mcp

Claude.aiがOAuthの手順を案内します（キーを手動で貼り付ける必要はありません）。これで完了です。

オプション2 — 直接設定（hl_live_キー認証を使いたい上級者向け）

claude_desktop_config.jsonを編集します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hooklayer": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]",
        "https://hooklayer.dev/api/mcp",
        "--header",
        "Authorization:Bearer hl_live_..."
      ]
    }
  }
}

無料のhl_live_キーは**https://hooklayer.dev/auth/signup**で取得できます。生涯利用可能なクレジットが100付与され、カード登録は不要です。

Claude Desktopを再起動します。コネクター一覧🔌にHooklayerの12個のツールが表示されます。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "hooklayer": {
      "url": "https://hooklayer.dev/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer hl_live_..."
      }
    }
  }
}

n8n

ワークフローにMCP Clientノードを追加し、リモート HTTP MCP サーバーとして設定します。

• URL：https://hooklayer.dev/api/mcp
• トランスポート：HTTP
• ヘッダー：Authorization: Bearer hl_live_...

ノードの「Tool」ドロップダウンに12個すべてのツールが表示されます。

OAuth 2.1 + PKCE（Claude.aiコネクターおよびカスタムアプリ向け）

Hooklayerは、ディスカバリー、動的クライアント登録、PKCE、リフレッシュトークンのローテーションに対応した、完全準拠のOAuth 2.1を実装しています。APIキーよりOAuthを優先するMCPクライアントでも、すぐに利用できます。

ディスカバリーエンドポイント（認証不要。機械可読形式）：

# Authorization server metadata (RFC 8414)
curl https://hooklayer.dev/.well-known/oauth-authorization-server

# Protected resource metadata (RFC 9728)
curl https://hooklayer.dev/.well-known/oauth-protected-resource

動的クライアント登録（手動のサインアップフォームを使わずにクライアントを作成）：

curl -X POST https://hooklayer.dev/oauth/register \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "Your MCP client",
    "redirect_uris": ["https://yourapp.com/oauth/callback"]
  }'
# Returns: client_id, client_secret (for confidential clients)

認証なしでtools/callにアクセスすると、リソースメタデータを示すWWW-Authenticateヘッダーを含む401が返されます。Claude.ai、Cursor、その他のMCPクライアントはこれを使ってOAuthフローを自動検出します。

その他のクライアント

任意のHTTP MCPクライアントで利用できます。プロトコルは2024-11-05（最も幅広い互換性）または2025-06-18（Streamable HTTP + structuredContent）をネゴシエートします。

# Quick test — initialize handshake works without auth:
curl -X POST https://hooklayer.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

---

🧠 12 個のツール

ツール	クレジット	機能
analyze_account	5	クリエイターを詳細に分析します（TikTok、YouTube、Instagram）：バイラル DNA スコア、フォーマットの特徴、文字起こし付きの人気動画、コンテンツの不足箇所、見出しに関する分析、次に行う調査の提案を返します。
search_videos	1	TikTok または Instagram でキーワード検索を行います。エンゲージメント順に最大 20 件の動画を表示し、ニッチ、再生回数、投稿時期、地域で絞り込めます。
score_hook	1	実証済みのバイラルパターンに基づき、フックを 0〜100 点で評価します。品質を高めた 3 つの書き換え案を返します。
viral_remix	3	URL または文字起こしから、バイラル DNA を反映した新しいスクリプトを作成します。カメラショットを含むシーンごとの構成です。
trend_pulse	1	ニッチごとに、リアルタイムで伸びている機会と飽和したパターンを提示します。キャッシュは 12 時間です。
find_viral_template	1	ニッチに合ったテンプレートを順位付けして提示します。フックのパターンと例の URL も含まれます。
match_voice	2	3 件以上のサンプルからクリエイターのボイス DNA を抽出し、そのスタイルに合わせて下書きを書き換えます。
predict_virality	2	公開前に、下書きのスクリプトがバイラルになる可能性を評価します。リテンションの診断も行います。
brief_to_blueprint	7	ブランドのブリーフから、1 ページのクリエイティブブループリントを作成します。フック、テンプレート、ハッシュタグ、トレンドの勢いの確認、撮影指示を 1 回の呼び出しでまとめます。
watch_account	0 または 5	クリエイターのウォッチを保存し、基準スナップショットを作成します。利用可能な場合は、最近の互換性のある分析を 0 クレジットで再利用します。そうでない場合は、新たに 5 クレジットで分析します。
list_watches	0	認証済みユーザーが保存したクリエイターのウォッチと、簡潔な追跡メタデータを一覧表示します。
get_changes	5	保存済みのウォッチを新たに分析し、前回のスナップショットと比較します。新しい履歴スナップショットを保存し、重要な変化と任意の次のアクションを返します。

完全なスキーマと curl の使用例：https://hooklayer.dev/docs

---

💡 推奨される次のステップ

analyze_account は recommended_chain フィールドを返します。このフィールドには、関連ツール、パラメーターの例、それぞれが次に役立つ理由を示すプレーンデータが含まれます。あくまで参考情報であり、実行するかどうかはエージェントとユーザーが決定します。

{
  "viral_dna_score": 87,
  "steal_map": [...],
  "recommended_chain": [
    {
      "tool": "match_voice",
      "params": {
        "draft": "<<<USER_DRAFT>>>",
        "reference_samples": ["https://tiktok.com/...", "...", "..."]
      },
      "reason": "High-signal voice DNA — consistent across top 5 videos"
    },
    {
      "tool": "trend_pulse",
      "params": { "niche": "challenge_videos" },
      "reason": "Verify their formula maps to current trends"
    },
    {
      "tool": "viral_remix",
      "params": { "source_url": "https://tiktok.com/..." },
      "reason": "Their #2 video has the highest copyable structure"
    }
  ]
}

これらの項目は情報データであり、指示ではありません。各ツールは引き続き明示的な呼び出しが必要です。エージェントまたはユーザーの同意なしに自動実行されることはありません。

---

📦 使用例

• examples/typescript-example.ts — MCP SDK を使用した TypeScript の使用例
• examples/python-example.py — anthropic-mcp クライアントを使用した Python の使用例
• examples/curl-test.sh — すべてのエンドポイントを対象とした curl による直接テスト

---

💵 料金

• 無料 — 登録時に生涯有効の 100 クレジットを付与。カード不要
• Starter — 月額 $49、5,000 クレジット、毎分 60 リクエスト
• Pro — 月額 $149、25,000 クレジット、毎分 300 リクエスト、ブランドボイスメモリー
• Agency — 月額 $499、150,000 クレジット、毎分 1,000 リクエスト、ホワイトラベル、10 席
• 従量課金 — 5,000 クレジットで $25。有効期限なし

料金の詳細：https://hooklayer.dev/pricing

---

🛠 アーキテクチャ

ホスト型 MCP サーバー（stdio のインストールは不要）：

Your agent (Claude/Cursor/n8n)
        │
        │  JSON-RPC 2.0 over HTTP
        ▼
https://hooklayer.dev/api/mcp
        │
        ├── initialize / ping / tools/list  (no auth)
        └── tools/call                       (Bearer hl_live_*)
                │
                └── Routes internally to /v1/* REST endpoints
                    100K+ analyzed viral videos
                    ScrapeCreators + Whisper + Sonnet pipeline

ホスト型サーバーのソースコードは hooklayer.dev にあります（クローズドソースです。分析パイプラインが競争優位性の源泉です）。このリポジトリには、公開クライアント向けドキュメント、使用例、設定スニペットが含まれています。

---

📚 リンク

• インストールページ：https://hooklayer.dev/mcp
• ドキュメント全文：https://hooklayer.dev/docs
• プレイグラウンド（登録不要）：https://hooklayer.dev/playground
• 料金：https://hooklayer.dev/pricing
• OAuth メタデータ：/.well-known/oauth-authorization-server
• イシューとバグ報告：GitHub Issues

---

🔒 セキュリティ

Hooklayer は、12 個すべてのツールに明示的な MCP 安全性アノテーションを使用しています。 ほとんどのツールは調査・分析ツールであり、Hooklayer のクレジットを消費し、サービス利用状況を記録する場合があります。list_watches は読み取り専用です。クリエイターのモニタリングでは、破壊を伴わない永続化が追加されます。watch_account はクリエイターの監視対象とベースラインスナップショットを保存し、get_changes は変更を確認する際に過去のスナップショットを保存します。すべてのツールに destructiveHint: false が設定されています。Hooklayer には、ユーザーデータを削除したり、外部のソーシャルプラットフォーム上のデータを編集・削除したりする MCP ツールはありません。

認証： tools/call には Bearer トークン（hl_live_* API キーまたは OAuth 2.1 アクセストークン）が必要です。公開メソッド（initialize、ping、tools/list）は認証なしで使用できるため、MCP クライアントは認証前にハンドシェイクを行い、ツールを検出できます。

recommended_chain はあくまで参考情報です。 analyze_account のレスポンスには、パラメーターが事前入力された、次に使用するツールの候補が含まれます。これらはデータであり、実行するかどうかはエージェントとユーザーが判断します。サーバー側で、ツール呼び出しが別のツール呼び出しを引き起こすことはありません。

データの取り扱い： Hooklayer は、分析結果を返すために、送信された入力（ハンドル、フック、スクリプト、URL）を処理します。クリエイターのモニタリングでは、ユーザーが時間の経過に伴う変化を比較できるよう、保存済みの監視対象メタデータと過去のスナップショットを保持します。また、認証、課金、クレジット、運用テレメトリに必要なサービス利用状況も記録します。

セキュリティ上の問題は、GitHub Issues または [email protected] までご報告ください。

---

📄 ライセンス

MIT — LICENSE を参照してください。

このリポジトリ内の MCP クライアントのサンプルと設定スニペットは MIT ライセンスです。ホスト型サービスの hooklayer.dev は商用製品で、料金プランは上記のとおりです。