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のWeb/デスクトップ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",
        "mcp-remote@0.1.38",
        "https://hooklayer.dev/api/mcp",
        "--header",
        "Authorization:Bearer hl_live_..."
      ]
    }
  }
}

無料のhl_live_キーは**https://hooklayer.dev/auth/signup**で取得できます — 生涯100クレジット、カード不要。

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

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

• Transport: HTTP

• Header: Authorization: Bearer hl_live_...

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

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

Hooklayerは完全にOAuth 2.1準拠です — ディスカバリー、動的クライアント登録、PKCE、リフレッシュトークンのローテーション。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にアクセスすると、401と、リソースメタデータを指すWWW-Authenticateヘッダーが返されます — 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"}'

Related MCP server: tiktok-viral-factory

🧠 12のツール

完全なスキーマと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クレジット、カード不要

• スターター — 月額$49、5,000クレジット、60リクエスト/分

• プロ — 月額$149、25,000クレジット、300リクエスト/分、ブランドボイスメモリ

• エージェンシー — 月額$499、150,000クレジット、1,000リクエスト/分、ホワイトラベル、10シート

• 従量課金 — $25で5,000クレジット、期限切れなし

完全な価格：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）を処理して分析結果を返します。クリエイターモニタリングは、ユーザーが時間の経過に伴う変更を比較できるように、保存されたウォッチメタデータと履歴スナップショットを保存します。Hooklayerはまた、認証、請求、クレジット、運用テレメトリに必要なサービス使用状況を記録します。

セキュリティ問題の報告：GitHub Issuesまたはsecurity@hooklayer.devまでメールでお願いします。

📄 ライセンス

MIT — LICENSEを参照。

このリポジトリのMCPクライアント例と設定スニペットはMITです。hooklayer.devのホスト型Hooklayerサービスは、上記の価格帯を持つ商用製品です。