Cap HTTP Request
Apps & Automationcap_http_requestCap HTTP Request is an Agent Skill for apps & automation published in the espressif/esp-claw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Call allowlisted HTTP or HTTPS endpoints directly and return response status plus body text, or stream the response body to a file.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/espressif/esp-claw/blob/HEAD/components/claw_capabilities/cap_http_request/skills/cap_http_request/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/cap-http-request, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
HTTP Request
Use this skill when the task needs a direct HTTP or HTTPS request to a known endpoint instead of search-engine results.
When to use
- The user needs raw API or file content from a specific URL.
- A workflow already knows the target endpoint and only needs a guarded fetch.
- The request should stay inside the device allowlist policy.
Available capability
http_request: send standard HTTP requests to allowlisted domains or IPs and return status plus body text, or save the response body directly to a file.
Calling rules
- Only call
http_requestwhen the target host is expected to be in the configured allowlist. - Input must be a JSON object:
{
"url": "https://api.example.com/v1/data",
"method": "GET",
"headers": {
"Authorization": "Bearer <token>"
},
"body": "",
"timeout_ms": 15000,
"max_body_bytes": 16384,
"save_path": "/spiffs/download.bin",
"max_file_bytes": 1048576
}
urlis required and must start withhttp://orhttps://.methoddefaults toGET.bodyis only valid for methods that accept a request body.save_pathis optional. When present, the response body is streamed directly to this file and is not returned in memory.max_body_bytesapplies only when returning the response body as text.max_file_bytesis optional and applies only whensave_pathis present.- Redirects are allowed only when the redirect target also matches the allowlist.
Output shape
- The capability returns plain text, not JSON.
- Success format:
HTTP <status>- followed by the response body text
- File-save success format:
HTTP <status>Saved response body to <path> (<bytes> bytes)
- Common error strings include:
Error: HTTP allowlist is empty; configure search_http_allowlist firstError: host '...' is not in allowlistError: method must be GET/POST/PUT/PATCH/DELETE/HEADError: save_path must be a non-empty stringError: failed to open save_pathError: http request failed (...)
Examples
{
"url": "https://skills-lab.esp-claw.com/raw/tags.json"
}
{
"url": "https://api.example.com/v1/items",
"method": "POST",
"headers": {
"Content-Type": "application/json"
},
"body": "{\"name\":\"demo\"}"
}
{
"url": "https://example.com/file.bin",
"save_path": "/spiffs/file.bin",
"max_file_bytes": 10485760
}