tomevault-io 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 请求
{
"url": "https://httpbin.org/get",
"method": "GET",
"params": {"name": "test"}
}
POST 请求
{
"url": "https://httpbin.org/post",
"method": "POST",
"headers": {"Content-Type": "application/json"},
"body": {"message": "hello world"}
}
天气查询（推荐 Open-Meteo，免费无 key）
{
"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 获取城市/地点摘要（推荐，限流较宽松）
{
"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）
{
"url": "https://en.wikipedia.org/w/api.php",
"method": "GET",
"params": {"q": "Chiang Mai tourism"}
}
Runtime
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
Converted and distributed by TomeVault — claim your Tome and manage your conversions.