ionclaw-org/ionclaw/http-client

Claude Code and agent skill by ionclaw-org/ionclaw

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Make HTTP requests (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS) to APIs and web services. Use when the user needs to call a REST API, fetch data from an endpoint, send form data, upload files, download files, or test HTTP services.

Install

npx vskill@latest install ionclaw-org/ionclaw/http-client

SKILL.md

HTTP Client

Use the http_client tool to make HTTP requests directly without needing curl or external binaries.

Tool: http_client

Parameters
ParameterTypeRequiredDescription
methodstringYesGET, POST, PUT, DELETE, PATCH, HEAD, or OPTIONS
urlstringYesRequest URL
headersobjectNoHTTP headers as key-value pairs
bodystringNoRequest body
content_typestringNoBody content type: json (default), form, text, or xml
authstringNoAuth profile name for authenticated requests (configured in config)
timeoutintegerNoTimeout in seconds (default: 30)
follow_redirectsbooleanNoFollow redirects (default: true)
download_pathstringNoSave response body to this file path
upload_filestringNoPath to file to upload as multipart form data
upload_fieldstringNoForm field name for uploaded file (default: file)
Basic GET
http_client(method="GET", url="https://api.example.com/users")
GET with query parameters
http_client(method="GET", url="https://api.example.com/users?page=2&limit=10")
GET with custom headers
http_client(method="GET", url="https://api.example.com/users", headers={"Accept": "application/json", "X-Custom-Header": "value"})
POST with JSON body
http_client(method="POST", url="https://api.example.com/users", body="{\"name\": \"Alice\", \"email\": \"alice@example.com\"}")

The content_type defaults to json, which sets Content-Type: application/json automatically.

POST with form-encoded body
http_client(method="POST", url="https://api.example.com/login", content_type="form", body="username=alice&password=secret")
POST with XML body
http_client(method="POST", url="https://api.example.com/soap", content_type="xml", body="<request><action>query</action></request>")
PUT (full update)
http_client(method="PUT", url="https://api.example.com/users/42", body="{\"name\": \"Alice Updated\", \"email\": \"alice@example.com\"}")
PATCH (partial update)
http_client(method="PATCH", url="https://api.example.com/users/42", body="{\"name\": \"Alice Updated\"}")
DELETE
http_client(method="DELETE", url="https://api.example.com/users/42")
HEAD (check resource existence)
http_client(method="HEAD", url="https://api.example.com/users/42")
OPTIONS (check allowed methods)
http_client(method="OPTIONS", url="https://api.example.com/users")

Authentication

Auth profiles (recommended)

Use the auth parameter with a configured profile name. Auth profiles support OAuth 1.0a, Basic, and Bearer authentication automatically:

http_client(method="POST", url="https://api.twitter.com/2/tweets", auth="twitter", body="{\"text\": \"Hello!\"}")
http_client(method="GET", url="https://api.example.com/data", auth="my_api")
Manual headers

You can also pass auth headers manually:

http_client(method="GET", url="https://api.example.com/me", headers={"Authorization": "Bearer eyJhbGciOi..."})
http_client(method="GET", url="https://api.example.com/me", headers={"Authorization": "Basic dXNlcjpwYXNz"})
http_client(method="GET", url="https://api.example.com/data", headers={"X-API-Key": "your-api-key"})

Download

Save a response directly to a file using download_path. Use paths relative to the project root:

http_client(method="GET", url="https://example.com/report.pdf", download_path="reports/report.pdf")

Download an image to the public media directory:

http_client(method="GET", url="https://example.com/photo.jpg", download_path="public/media/photo.jpg")

Returns: {"status": 200, "path": "public/media/photo.jpg", "size": 12345, "content_type": "application/pdf"}

Upload

Upload a file as multipart form data using upload_file:

http_client(method="POST", url="https://api.example.com/upload", upload_file="reports/data.csv")

Custom field name (default is "file"):

http_client(method="POST", url="https://api.example.com/upload", upload_file="images/logo.png", upload_field="image")

Upload with extra form fields (pass as JSON in body):

http_client(method="POST", url="https://api.example.com/upload", upload_file="doc.pdf", body="{\"description\": \"Monthly report\"}")

Upload with auth:

http_client(method="POST", url="https://api.example.com/upload", upload_file="data.csv", headers={"Authorization": "Bearer token123"})

Advanced Options

Custom timeout
http_client(method="GET", url="https://slow-api.example.com/data", timeout=120)
Disable redirect following
http_client(method="GET", url="https://example.com/redirect", follow_redirects=false)

Tips

  • The response includes status, headers, body, and truncated fields.
  • Response bodies larger than 50,000 characters are truncated.
  • For APIs that return JSON, parse the response body as needed.
  • The content_type parameter sets the Content-Type header automatically: json → application/json, form → application/x-www-form-urlencoded, text → text/plain, xml → application/xml.
  • Use GET for reads, POST for creates, PUT for full replacements, PATCH for partial updates, DELETE for removals, HEAD for existence checks, OPTIONS for CORS/capability checks.
  • Use download_path for binary files (images, PDFs, audio) — avoids encoding issues.
  • Use upload_file for multipart uploads — auto-detects MIME type from file extension.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
69
Repository forks
14
7-day trend score
21

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 26 Jun 2026, 4 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ionclaw-org/ionclaw/http-client/badge)](https://verified-skill.com/skills/ionclaw-org/ionclaw/http-client)

Something wrong with this skill or its page? Tell us.