agent-hoppscotch
让AI智能体通过命令行管理Hoppscotch API协作平台
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agent-hoppscotch。 它的用途是：让AI智能体通过命令行管理Hoppscotch API协作平台 完整的 Skill 内容见：https://321skill.com/skills/agent-hoppscotch/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在Hoppscotch的‘测试项目’集合下创建一个新的POST请求，用于用户注册，URL是{{BASE_URL}}/api/register，并设置好JSON请求体和Bearer Token认证。” 它会使用 `agent-hoppscotch request create` 命令，结合已配置的默认团队和集合ID，快速生成该请求的定义并保存到指定的Hoppscotch集合中。
介绍
agent-hoppscotch 是一个专为AI智能体设计的CLI工具，它解决了在自动化流程中难以直接操作Hoppscotch API协作平台的问题。通过这个工具，AI可以直接在命令行中管理Hoppscotch的团队、集合、API请求和环境变量，无需人工介入浏览器界面。
使用方式非常简单，首先通过 auth 命令配置GraphQL端点和浏览器Cookie完成认证，之后即可使用 team、collection、request、env 等子命令进行各类资源的增删改查操作。所有命令都支持 --json 标志输出结构化数据，便于AI解析和后续处理。
这个工具非常适合需要将API管理集成到自动化脚本或AI工作流中的开发者。无论是全栈开发、运维工程师还是智能体开发者，都可以利用它来批量创建测试请求、同步团队配置或搭建CI/CD流程中的API测试环节。
使用前请注意，你需要拥有一个Hoppscotch实例（自托管或云服务）并获取有效的会话Cookie。建议在安全的环境中使用，妥善保管认证信息，并利用 --verbose 标志在调试时查看原始GraphQL交互。
核心特点
与通用HTTP客户端或Postman CLI不同，它深度集成Hoppscotch的GraphQL API，提供了针对团队协作、集合管理和环境变量等Hoppscotch特有资源的原子化操作命令，更适合在AI驱动的自动化流程中精确管理API协作项目。
注意事项
不适合用于直接发送和测试单个API请求（这是Hoppscotch UI或curl等工具更擅长的），其主要定位是API协作项目的元数据管理。
常见问题
如何获取Hoppscotch的认证Cookie？
在浏览器登录Hoppscotch后，打开开发者工具（F12），在Application或存储标签页中查找名为 `connect.sid`、`access_token` 或 `refresh_token` 的Cookie值并复制。
这个工具能用来发送API请求吗？
不能。它的主要功能是管理Hoppscotch平台上的请求定义、集合、团队等元数据，而不是执行这些HTTP请求。发送请求需要在Hoppscotch UI或其他HTTP客户端中进行。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-hoppscotch/raw/index.md 读取 agent-hoppscotch 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-hoppscotch/raw/index.md（查看排版版本）