# HTTP Request

> 发起 HTTP 网络请求，支持 GET、POST、PUT、DELETE、PATCH 方法。当用户需要调用 API、获取网页内容、发送数据到服务器时使用。

- Skill: `tools-only/http-request` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add tools-only/http-request`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/http-request/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: MIT
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/tools-only/http-request

---


# HTTP Request Skill

一个通用的 HTTP 网络请求技能，支持常见的 RESTful API 调用。

## 功能特性

- 支持 GET、POST、PUT、DELETE、PATCH 方法
- 支持自定义请求头
- 支持 JSON 请求体
- 支持 URL 查询参数
- 支持超时设置
- **旧版 SSL 兼容**：支持连接使用旧版 TLS 的服务器（如部分政府/教育网站）
- **浏览器级 User-Agent**：减少 503/反爬拦截
- **自动重试**：对 502/503/504 自动重试 2 次

## 使用示例

### GET 请求
```json
{
  "url": "https://httpbin.org/get",
  "method": "GET",
  "params": {"name": "test"}
}
```

### POST 请求
```json
{
  "url": "https://httpbin.org/post",
  "method": "POST",
  "headers": {"Content-Type": "application/json"},
  "body": {"message": "hello world"}
}
```

## Runtime

```yaml
entry_point: scripts/main.py
language: python
network:
  enabled: true
  outbound:
    - "*:80"
    - "*:443"
  block_private_ips: false
input_schema:
  type: object
  properties:
    url:
      type: string
      description: 请求的完整 URL
    method:
      type: string
      description: HTTP 请求方法
      enum:
        - GET
        - POST
        - PUT
        - DELETE
        - PATCH
      default: GET
    headers:
      type: object
      description: 自定义请求头
      additionalProperties:
        type: string
    body:
      type: object
      description: 请求体数据，用于 POST/PUT/PATCH，将以 JSON 格式发送
    params:
      type: object
      description: URL 查询参数
      additionalProperties: true
    timeout:
      type: number
      description: 请求超时时间（秒），默认 30 秒
      default: 30
    use_legacy_ssl:
      type: boolean
      description: 是否启用旧版 SSL 兼容（连接 cscse.edu.cn、lxgz.org.cn 等旧服务器时需 true）
      default: true
  required:
    - url
```