---
name: HTTP Request
slug: http-request
category: Automation
description: HTTP Request sends GET, POST, PUT, DELETE, and PATCH requests to APIs or web servers. Use it to fetch page content, submit data, or interact with REST endpoints.
github: "https://github.com/EXboys/evotown/tree/main/backend/arena_skills/http-request"
language: Python
stars: 663
forks: 63
install: "npx degit https://github.com/EXboys/evotown/tree/main/backend/arena_skills/http-request ~/.claude/skills/http-request"
installs_to: ~/.claude/skills/http-request
source_path: backend/arena_skills/http-request/SKILL.md
collection_size: 8
category_size: 1523
collection_url: "https://dirskills.com/collections/EXboys/evotown"
added: 2026-08-24T05:17:05.827Z
last_synced: 2026-08-24T05:17:05.827Z
canonical_url: "https://dirskills.com/skills/http-request"
---

# HTTP Request

HTTP Request sends GET, POST, PUT, DELETE, and PATCH requests to APIs or web servers. Use it to fetch page content, submit data, or interact with REST endpoints.

**Install:**

```bash
npx degit https://github.com/EXboys/evotown/tree/main/backend/arena_skills/http-request ~/.claude/skills/http-request
```

## README

# HTTP Request Skill

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

## 功能特性

- 支持 GET、POST、PUT、DELETE、PATCH 方法
- 支持自定义请求头
- 支持 JSON 请求体
- 支持 URL 查询参数
- 支持超时设置
- **旧版 SSL 兼容**：支持连接使用旧版 TLS 的服务器（如部分政府/教育网站）
- **浏览器级 User-Agent**：减少 503/反爬拦截
- **Wikipedia/Wikimedia 合规**：访问 wikipedia.org / wikimedia.org / wikidata.org 时自动使用合规 User-Agent（否则易 403），并加 1.5 秒间隔降低限流
- **自动重试**：对 502/503/504 自动重试 2 次
- **HTML→Markdown**：网页响应自动转为 Markdown（默认），降低 token 消耗

## 使用示例

### 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"}
}
```

### 天气查询（推荐 Open-Meteo，免费无 key）
```json
{
  "url": "https://api.open-meteo.com/v1/forecast",
  "method": "GET",
  "params": {
    "latitude": 18.7883,
    "longitude": 98.9853,
    "daily": "temperature_2m_max,temperature_2m_min,weathercode",
    "timezone": "Asia/Bangkok",
    "forecast_days": 2
  }
}
```
清迈坐标 18.7883,98.9853。返回 JSON 含 daily.time、temperature_2m_max/min、weathercode。

wttr.in 亦可用：`https://wttr.in/Chiang_Mai?format=j1`，skill 会自动用 curl UA 以获取 JSON。

### Wikipedia 获取城市/地点摘要（推荐，限流较宽松）
```json
{
  "url": "https://en.wikipedia.org/api/rest_v1/page/summary/Chiang_Mai",
  "method": "GET"
}
```
或 `.../page/summary/Bangkok`。返回 JSON 含 extract、description、title 等。

### Wikipedia 搜索 API（params 可用 q，skill 会自动转为 action=query&list=search）
```json
{
  "url": "https://en.wikipedia.org/w/api.php",
  "method": "GET",
  "params": {"q": "Chiang Mai tourism"}
}
```

## 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
    extract_mode:
      type: string
      description: HTML 响应提取模式，markdown=转为 Markdown（默认），text=纯文本，raw=原始 HTML
      enum:
        - markdown
        - text
        - raw
      default: markdown
  required:
    - url
```