Hooklayer MCP

面向 AI 代理的病毒式内容智能。 将 Hooklayer MCP 服务器放入 Claude Desktop、Cursor、n8n 或任何 HTTP MCP 客户端，你的代理即可获得 12 个工具，用于 TikTok、Instagram 和 YouTube 上的短视频内容：分析创作者、按关键词搜索视频、查找病毒式模板和上升趋势、评分并重写钩子、混剪病毒式视频、匹配创作者的声音、预测草稿的病毒式传播潜力、将品牌简报转化为可拍摄的创意蓝图，以及通过保存的观察和歷史快照持续监控创作者。

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 桥接。有两种安装方式：

选项 1 — 自定义连接器（最简单，无需编辑配置文件）

在 Claude 的网页/桌面界面中：设置 → 连接器 → 添加自定义连接器 → 粘贴此 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_..."
      ]
    }
  }
}

在 https://hooklayer.dev/auth/signup 获取免费的 hl_live_ 密钥——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 客户端 节点，并将其配置为远程 HTTP MCP 服务器：

• URL：https://hooklayer.dev/api/mcp

• 传输：HTTP

• 标头：Authorization: Bearer hl_live_...

所有 12 个工具都会出现在节点的“工具”下拉菜单中。

OAuth 2.1 + PKCE（适用于 Claude.ai 连接器和自定义应用）

Hooklayer 完全符合 OAuth 2.1 规范——发现、动态客户端注册、PKCE、刷新令牌轮换。偏好 OAuth 而非 API 密钥的 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 服务是商业产品，定价层级如上所列。