前言¶
调试接口、拉取公开 API、向 webhook 投递数据时,开发者往往要在终端或 Postman 里单独发请求,再把响应贴回给 AI。Agent 本身通常不能直接访问任意 URL。若希望模型在完成任务时「顺手」完成一次 GET 或 POST,并把响应体带回上下文,需要一个明确的 HTTP 请求 Skill。
下面介绍 SkillHub 社区技能 http-request(坐标 @user_57562667/http-request):在 Agent 侧封装发起 GET/POST 并返回响应结果的能力,且标注 requires_api_key=false,不依赖额外 API Key 配置。
这是什么¶
http-request 是 SkillHub 上分类为 ai-agent 的社区技能(来源 community),当前页面版本为 v1.0.2,由发布者 user_57562667 维护。
官方一句话说明:HTTP 请求技能,发起 GET/POST 请求并返回响应结果。定位很直白——给 Agent 一条可复用的 HTTP 调用约定,而不是替代 curl、网关或生产级 HTTP 客户端库。
核心功能¶
根据 SkillHub 页面与 API 摘要,目前能核实的能力只有下列几项:
- 支持 GET、POST 两类 HTTP 方法。
- 执行请求后,将 响应结果 返回给 Agent(便于后续解析、总结或写入任务上下文)。
- 标签 requires_api_key=false:安装与使用不要求在 Skill 层单独配置 API Key(具体目标 URL 若需要鉴权,仍由请求头、Cookie 或环境变量等常规方式处理,以 Skill 内说明为准)。
页面未公开更细的参数表(超时、重试、自定义 Header 等)。未在官方资料中出现的能力,本文不展开。
安装与启用¶
SkillHub 提供两种常见安装路径:用 CLI 装到当前 Agent 的 skills 目录,或把安装提示词交给 AI 按官方文档执行。
方式一:SkillHub CLI¶
先确认本机是否已有 skillhub(完整步骤见 SkillHub 安装与优先源配置)。安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录,否则默认落在 ./skills/,Agent 可能读不到。
command -v skillhub && skillhub --version
skillhub install @user_57562667/http-request --dir <skills 目录>
各客户端 skills 目录示例(摘自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
装好后按你所用 Agent 的惯例刷新或重启,使 Skill 被加载。
方式二:让 AI 按文档安装¶
SkillHub 页面给出的提示词为:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_57562667/http-request`。
将上述内容发给支持 Skill 安装的 Agent,由它按 skillhub.md 完成 CLI 检查与 install 命令。
典型用法¶
公开页面未附带完整的 SKILL.md 正文或逐步示例。从简介可推断的用法模式如下(具体触发话术以安装后 Skill 内指令为准):
- 在对话中说明要访问的 URL 与 方法(GET 或 POST)。
- 若为 POST,补充请求体格式(如 JSON)及必要 Header。
- Agent 调用本 Skill 发起请求,并将响应内容返回,供你或模型继续处理。
复现前请先完成安装,并在同一会话中确认 Agent 已加载 @user_57562667/http-request。
适用场景与注意¶
适合:
- 需要 Agent 拉取公开 HTTP API、健康检查地址或文档型 JSON。
- 向测试环境 webhook、表单接口发送 POST,并把响应交给模型解读。
- 希望减少「你手动 curl → 粘贴响应」的往返。
注意:
- 仅核实到 GET/POST;复杂认证、文件上传、流式响应等是否支持,需以 Skill 实际说明为准。
- Agent 发起的 HTTP 会走运行环境网络策略;内网地址、敏感生产接口应自行评估风险。
- SkillHub 统计(以抓取资料为准):评分 100000,下载 623,安装 2;社区技能更新节奏取决于发布者,使用前可在页面确认 v1.0.2 是否仍是最新。
结尾¶
http-request 把「发 GET/POST 并拿回响应」收敛成 Agent 可调用的一项能力,适合在开发与联调场景里减少上下文切换。安装与坐标以 SkillHub 为准。
- SkillHub 页面:https://www.skillhub.cn/skills/user_57562667/http-request
- API 摘要:https://api.skillhub.cn/user_57562667/http-request