Hooklayer

Hooklayer MCP

面向 AI Agent 的病毒式内容情报。 将 Hooklayer MCP 服务接入 Claude Desktop、Cursor、n8n 或任何 HTTP MCP 客户端，即可让你的 Agent 使用 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 的 Web 或桌面界面中：设置 → 连接器 → 添加自定义连接器 → 粘贴此 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_..."
      ]
    }
  }
}

在 https://hooklayer.dev/auth/signup 获取免费的 hl_live_ 密钥——提供 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_...

全部 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"}'

---

🧠 12 个工具

工具	点数	功能
analyze_account	5	深入分析创作者（TikTok、YouTube、Instagram）：爆款基因评分、内容形式特征、带文字稿的热门视频、内容空白、标题洞察，以及建议的后续研究步骤。
search_videos	1	在 TikTok 或 Instagram 上按关键词搜索，最多返回 20 个按互动度排序的视频，并可按细分领域、观看量、发布时间和地区筛选。
score_hook	1	根据经过验证的爆款模式，为任意开场白打 0-100 分，并提供 3 个质量更高的改写版本。
viral_remix	3	将 URL 或文字稿改编为带有相似爆款基因的新脚本，并按场景列出镜头。
trend_pulse	1	实时发现各细分领域正在兴起的机会和已饱和的模式。缓存 12 小时。
find_viral_template	1	按适配度排序的细分领域模板，附带开场白模式和示例 URL。
match_voice	2	从 3 个以上样本中提取创作者的语言风格特征，并按其风格改写草稿。
predict_virality	2	在发布前评估脚本草稿的爆款潜力，并诊断留存率。
brief_to_blueprint	7	将品牌简报转化为一页创意蓝图：通过一次调用提供开场白、模板、主题标签、趋势速度检查和拍摄说明。
watch_account	0 或 5	保存创作者关注项和基准快照。有可用的近期兼容分析时，复用该分析且不扣点数；否则会运行一次新的分析，扣除 5 点。
list_watches	0	列出已通过身份验证的用户保存的创作者关注项及精简的跟踪元数据。
get_changes	5	针对已保存的关注项运行一次新分析，与上一份快照对比，保存新的历史快照，并返回重要变化及可选的下一步操作。

完整架构和 curl 示例：https://hooklayer.dev/docs

---

💡 建议的后续操作

analyze_account 会返回一个 recommended_chain 字段，其中包含相关工具、示例参数以及每项工具可能有用的原因等纯数据。它仅供参考，是否采取行动由 Agent 和用户决定：

{
  "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"
    }
  ]
}

这些条目是信息数据，并非指令。每个工具仍需显式调用；未经 Agent 或用户同意，不会自动运行任何操作。

---

📦 示例

• examples/typescript-example.ts — 通过 MCP SDK 使用 TypeScript
• examples/python-example.py — 通过 anthropic-mcp 客户端使用 Python
• examples/curl-test.sh — 对每个端点进行原始 curl 测试

---

💵 定价

• 免费 — 注册时赠送 100 点终身额度，无需银行卡
• 入门版 — 每月 $49，5,000 点，60 req/min
• 专业版 — 每月 $149，25,000 点，300 req/min，品牌语气记忆
• 代理机构版 — 每月 $499，150,000 点，1,000 req/min，白标，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 响应中包含建议的后续工具及其预填参数。这些只是数据——是否执行由 Agent 和用户决定。任何工具调用都不会在服务端触发额外的工具调用。

数据处理： Hooklayer 会处理你发送的输入（账号标识、hook、脚本、URL），并返回分析结果。创作者监控会存储已保存的监控元数据和历史快照，供用户随时间对比变更。Hooklayer 还会记录身份验证、计费、积分和运营遥测所需的服务使用情况。

如需报告安全问题，请访问 GitHub Issues 或发送邮件至 [email protected]。

---

📄 许可证

MIT — 请参阅 LICENSE。

本仓库中的 MCP 客户端示例和配置片段遵循 MIT 许可证。托管于 hooklayer.dev 的 Hooklayer 服务是商业产品，提供上述定价档位。