内容
# 超级解决方案 — Claude 代码插件
Claude Code [插件](https://code.claude.com/docs/en/plugins) 教会 Claude
**集成和调试** 超级解决方案的反机器人 API（Akamai, Incapsula, DataDome, Kasada） 跨 Go, Python, 和 JavaScript/TypeScript 软件开发工具包（SDKs）以及原始 REST API — 并通过检查捕获的流量 **调试失败的请求**.
它包含两部分：
1. 一个 **技能** (`SKILL.md` + `references/`) 具有完整的集成 + 调试手册，包括 **请求指纹识别原则** 参考
(`references/request-rules.md`) 用于发现导致基于请求的机器人被阻止的错误（下面运行的 har-analyzer MCP 中执行详尽、始终最新的检查）。
2. 两个 **MCP 服务器** (`.mcp.json`)：
- **powhttp** — 实时检查脚本的真实线路流量（头顺序 + TLS 指纹）并将这些规则应用于它。
- **har-analyzer** — 一个托管的服务器，对导出的 **HAR** 运行相同的规则集并返回结构化结果 (`analyze_har`)。
向 Claude 提问，例如：
- "帮助我在 Python 中使用 tls-client 设置 Akamai 传感器流程。"
- "我的 DataDome 滑块解决方案返回 403 — 使用 powhttp 捕获我的脚本并告诉我出了什么问题。"
- "分析我捕获的请求并找出我被阻止的原因。"
- "为什么我的 `_abck` cookie 从未变为有效？"
## 安装
```bash
/plugin marketplace add Hyper-Solutions/hypersolutions-claude-code
/plugin install hypersolutions@hypersolutions
```
当您的提示符与超级解决方案/反机器人集成或请求调试工作匹配时，技能会自动激活（参见 `SKILL.md` 中的 `description`）。
### 开发
要在本地开发插件，请从检出中加载它，而不是从市场加载：
```bash
claude --plugin-dir /path/to/hypersolutions-claude-code
# 或，在现有会话中，编辑后重新加载：
/reload-plugins
```
## 使用 powhttp 请求调试器
捆绑的 MCP (`.mcp.json`) 指向 powhttp 的本地 MCP 服务器
(`http://localhost:8383/mcp`)。要使用它：
1. 安装并运行 [powhttp](https://powhttp.com); 点击 **"运行 MCP 服务器"**。
2. 将失败脚本的流量路由到 powhttp 的代理 (`http://127.0.0.1:8080`)
并运行流程。
3. 请求 Claude 调试它 — 它将通过 `powhttp` MCP 工具查询捕获的请求并分析头顺序、TLS 指纹、cookie 和客户端提示。
如果 powhttp 未运行，MCP 简单地没有可用的工具；您仍然可以分析用户导出的 HAR，方法是应用相同的规则。参见 `references/powhttp-mcp.md` 和
`references/request-rules.md`。
## 使用 HAR 分析器
捆绑的 `har-analyzer` MCP (`.mcp.json`) 是一个 **托管** 服务器
(`https://har-mcp.hypersolutions.co/mcp`)，它对导出的 HAR 运行超级解决方案的指纹规则集。这是分析客户发送的 HAR 的最快方法。
1. 在 Claude Code 运行的环境中设置您的 API 密钥：
```bash
export HYPERSOLUTIONS_API_KEY=<your-key> # 来自 https://hypersolutions.co/keys
```
配置将其作为 `x-api-key` 头发送；任何有效的超级解决方案密钥都有效。
2. 请求 Claude 分析 `.har` 文件 — 它调用 `analyze_har` 工具并报告结果（严重性、类别、修复）以及检测到的反机器人产品。
HAR 缺少真正的线路头顺序和 TLS 指纹，因此干净的结果并不排除这些 — 优先使用 powhttp 进行实时线路检查。参见 `references/har-analyzer-mcp.md`。
## 内部
```
.claude-plugin/plugin.json 插件清单
.mcp.json 捆绑的 MCP 服务器：powhttp（本地）+ har-analyzer（托管）
SKILL.md 入口点：思维模型、需求、路由、调试
scripts/sec_ch_ua.py 计算特定 Chrome 版本的 sec-ch-ua（GREASE）
references/
authentication.md x-api-key、JWT x-signature、组织头
tls-and-headers.md TLS 指纹识别、头顺序、IP/代理、Chrome 版本
akamai.md 传感器 (_abck)、sec-cpt 428、SBSD 429、像素
incapsula.md reese84、reese84 动态、utmvc、验证码阻止
datadome.md 中间页、滑块、标签
kasada.md 流程 1/2、有效载荷/cd/botid、POW、Vercel BotID
api-reference.md 所有端点、字段、每个 SDK 签名、原始 HTTP
powhttp-mcp.md 通过 powhttp MCP 进行实时请求捕获调试
har-analyzer-mcp.md 通过 har-analyzer MCP 进行自动 HAR 指纹分析
request-rules.md powhttp/实时捕获的指纹原则和编写请求
debugging.md 症状 → 原因 → 修复
```
## 维护此插件（IP 边界）
此存储库中提供的所有内容都是 **公共** 的 — 市场读取者可以在没有 API 密钥的情况下查看它。保持有价值的、不断演变的检测逻辑在此之外。编辑时的规则：
- **静态文件** (`SKILL.md`, `references/`, `scripts/`) 仅包含 **如何使用 API**
和 **众所周知的** 浏览器指纹识别事实（头顺序、sec-ch-ua GREASE、
公共 cookie/端点名称）。这是文档，不是护城河。
- **har-analyzer MCP** （服务器端，API 密钥保护）包含 **详尽且当前**
的检测规则 — 精确的阈值、每个产品的流程检查、随着检测演变而变化的内容。新或更新的检测逻辑放在 **那里，而不是这里**。
- 不要添加：反机器人的内部逆向工程（混淆/VM/有效载荷生成）、精确的内部阈值或命名的客户/目标应用程序。以通用格式描述并指向超级解决方案以获取详细信息。
当有疑问时：如果它教导某人如何 **使用** API，它可以放在这里；如果它揭示了超级解决方案 **知道或检查的内容**，它属于 MCP。
## 链接
- 仪表盘/API 密钥：https://hypersolutions.co/keys
- 文档：https://docs.hypersolutions.co
- 示例：https://github.com/Hyper-Solutions/hypersolutions-examples
- 软件开发工具包：[Go](https://github.com/Hyper-Solutions/hyper-sdk-go) ·
[Python](https://github.com/Hyper-Solutions/hyper-sdk-py) ·
[JS/TS](https://github.com/Hyper-Solutions/hyper-sdk-js)
- 支持：Discord `discord.gg/akamai`
