开放接口

用 HTTP GET 直接拉取已上架脚本清单、下载脚本源码。无需登录,适合第三方平台、青龙面板与自动化脚本接入。

查看原始 JSON 输出

快速上手 3 步跑通
  1. 调 查询列表 接口,拿到脚本的 id 和 download_url;
  2. 在 download_url 后面追加 &key=你的Key,请求即返回脚本文件;
  3. 保存文件即可使用 —— 运行前务必通读源码,警惕可疑外联与凭证窃取。

查询列表免鉴权;下载接口需要 API Key,由站方发放,请联系站长获取。

一、查询脚本列表

GET · 免鉴权
请求 https://qljb.qianmyun.cn/api.php?action=list
参数必填默认说明
action否list固定为 list,省略也是查列表
page否1页码,从 1 开始
size否10每页条数,上限 50(传 100 会被压成 50)
q否空关键词,对文件名和简介模糊匹配

仅返回已上架脚本(待审核 / 已拒绝不会出现);排序固定为最新在前;page 超出范围返回空数组,不报错。

cURL
curl -s "https://qljb.qianmyun.cn/api.php?action=list&page=1&size=20&q=京东"
把 size 调到 50 可减少请求次数

响应字段
字段类型说明
totalint符合条件的总条数(不是本页条数)
page / pageSizeint当前页码 / 实际每页条数(回显)
scriptsarray脚本数组,字段见下
scripts[].idint脚本 ID,下载时用
scripts[].filenamestring原始文件名
scripts[].typestringpy / js / ts / sh / zip
scripts[].descriptionstring脚本简介
scripts[].downloadsint累计下载次数
scripts[].tsint上传时间,Unix 时间戳(秒)
scripts[].created_atstring上传时间,服务端时区
scripts[].download_urlstring下载地址,不含 key,需自行追加

响应示例(JSON)
{
    "total": 128,
    "page": 1,
    "pageSize": 10,
    "scripts": [
        {
            "id": 132,
            "filename": "jd_fruit.py",
            "type": "py",
            "description": "京东农场自动化脚本",
            "downloads": 3421,
            "ts": 1758600000,
            "created_at": "2025-09-23 10:00:00",
            "download_url": "https://qljb.qianmyun.cn/api.php?action=download&id=132"
        }
    ],
    "note": "下载脚本需在 download 链接后追加 &key=YOUR_API_KEY"
}
中文不做 Unicode 转义,可直接阅读

在线试一试 在浏览器里直接发请求

接口已开启跨域(CORS),下面的请求由你的浏览器直接发出,不经过任何中转。

响应结果
点「发送请求」查看真实返回…

二、下载脚本

GET · 需要 Key
请求 https://qljb.qianmyun.cn/api.php?action=download
参数必填说明
action是固定为 download
id是脚本 ID,取自列表接口,必须为正整数
key是API Key,与站方发放的完全一致(区分大小写)

成功时返回文件二进制流(不是 JSON);每次调用会计一次下载量并记录 IP/UA, 请勿用脚本高频调用,否则会污染统计。

cURL(保存为文件)
curl -fsSL -o jd_fruit.py "https://qljb.qianmyun.cn/api.php?action=download&id=132&key=YOUR_API_KEY"
中文文件名已做 URL 编码,curl -O 会失真,建议手动指定文件名

注意Key 请只在服务端使用,不要写进前端页面、小程序或客户端安装包。

三、错误码

失败返回 JSON
状态码error原因怎么办
404unknown actionaction 不是 list / download检查拼写
401missing or invalid api key没传 key、key 不对,或站方未配置核对 key;换行/空格也会导致不匹配
400missing or invalid idid 缺失或非正整数用列表返回的 id
404script not found or not approved脚本不存在或未上架该脚本未过审,暂不可下载
404file missing记录还在但磁盘文件丢失联系站长修复

四、接入示例

复制即用
Python
python
import os, re, urllib.parse, requests

BASE = "https://qljb.qianmyun.cn/api.php"
KEY  = os.environ["QLJB_API_KEY"]      # Key 放环境变量,别硬编码

def fetch_list(page=1, size=20, q=""):
    r = requests.get(BASE, params={"action": "list", "page": page,
                                   "size": size, "q": q}, timeout=15)
    r.raise_for_status()
    return r.json()

def download(script_id, save_dir="."):
    r = requests.get(BASE, params={"action": "download", "id": script_id,
                                   "key": KEY}, timeout=30, stream=True)
    r.raise_for_status()
    # 服务端下发 filename="<urlencoded>",取回要 unquote,否则中文名会乱码
    cd = r.headers.get("Content-Disposition", "")
    m  = re.search(r'filename="([^"]+)"', cd)
    name = urllib.parse.unquote(m.group(1)) if m else f"script_{script_id}"
    path = os.path.join(save_dir, name)
    with open(path, "wb") as f:
        for chunk in r.iter_content(8192):
            f.write(chunk)
    return path

data = fetch_list(q="京东")
for s in data["scripts"]:
    print(s["id"], s["filename"], "->", download(s["id"]))
requests · 列表 + 下载
Node.js
javascript
const axios = require("axios");
const fs = require("fs");

const BASE = "https://qljb.qianmyun.cn/api.php";
const KEY  = process.env.QLJB_API_KEY;   // Key 放环境变量

async function fetchList(page = 1, size = 20, q = "") {
  const { data } = await axios.get(BASE, {
    params: { action: "list", page, size, q }, timeout: 15000,
  });
  return data;
}

async function download(id, out) {
  const r = await axios.get(BASE, {
    params: { action: "download", id, key: KEY },
    responseType: "stream", timeout: 30000,
  });
  await new Promise((res, rej) => {
    const w = fs.createWriteStream(out);
    r.data.pipe(w); w.on("finish", res); w.on("error", rej);
  });
}

const data = await fetchList(1, 20, "京东");
console.log("共", data.total, "个脚本");
await download(data.scripts[0].id, data.scripts[0].filename);
axios · 列表 + 下载
青龙面板定时批量拉取
bash
#!/usr/bin/env bash
# 放到青龙的定时任务里,定期同步脚本
API="https://qljb.qianmyun.cn/api.php"
KEY="YOUR_API_KEY"
DIR="/ql/data/scripts"

mkdir -p "$DIR"
curl -s "$API?action=list&page=1&size=50" \
  | jq -r '.scripts[] | "\(.id) \(.filename)"' \
  | while read -r id name; do
      curl -fsSL -o "$DIR/$name" "$API?action=download&id=$id&key=$KEY" \
        && echo "[OK] $name" || echo "[FAIL] $name"
    done
拉取最新 50 个脚本到青龙 scripts 目录

需要 jq;路径 /ql/data/scripts 按你的青龙实际目录调整。

五、常见问题

Q:查列表需要 Key 吗?
不需要,列表接口完全公开;只有下载需要 Key。

Q:为什么 size=100 只返回 50 条?
每页上限是 50,请分页拉取。

Q:列表里有,但下载报 404?
多为磁盘文件丢失(file missing),请联系站长。

Q:刚上传的脚本为什么查不到?
接口只返回已上架脚本,需管理员审核通过后才会出现。

Q:支持 POST 或 JSON Body 吗?
不支持,仅 GET + query string。

Q:Key 去哪里拿?
由站方发放,请联系站长。请勿在前端暴露 Key。

Q:能拿到脚本内容而不落盘吗?
可以,直接读取下载响应体即可,返回的就是文件原文。

提示接口为只读接口,不提供上传、删除等写操作;脚本均由网友上传,使用前请自行审阅源码。