红果云搬HG CLOUD
登录 / 注册
CLI · API · AGENT

敲一条命令，
让 Agent 替你搬剧。

hgc 把搜索、下单、进度、取链压成四个命令。 Claude Code 与 Codex 读完 help 就知道怎么用——不用你教它拼 HTTP。

Claude Code Codex 手动
curl -fsSL https://guoshi.app/cli/install.sh | sh -s -- \ --agent claude --key hgc_live_… 生成命令
先生成 Key，这条命令会自动带上 登录后即可生成
登录后生成命令 看命令清单
~/drama — claude hgc
$ hgc search "闪婚"
 1  闪婚老公竟是首富            82 集   0.82 U
    730123456789012345
 2  闪婚后我成了大佬的掌中宝    96 集   0.96 U
    730987654321098765

$ hgc submit 730123456789012345 --episodes 1-20
✓ job 1207 已排队 · 20 集 · 取件时结算 0.20 U

$ hgc status 1207 --watch
  ████████████░░░░░░░░  60%  12/20 集 · 失败 0 · 约 1m10s

$ hgc link 1207 --yes
✓ 已扣 0.20 U · 余额 9.76 U · 直链 24h 有效
→ 20 条分集直链（--json 可管道）

取链才扣费，且必须显式 --yes——Agent 不会自己花你的钱。

01

三步接入

全程复制粘贴，不用读文档

STEP 1

建一把 Key

在凭证卡新建，页面当场把 Key 拼进安装命令；明文只出现这一次。

凭证卡 · 新建密钥
STEP 2

一条命令装好

命令自带 Key 与 --agent：装 CLI、登录、写指令一次完成。

sh -s -- --agent --key …
STEP 3

直接开聊

回 Agent 说一句话就行，它自己 search → submit → status → link。

“帮我下《闪婚》前 20 集”
02

五个命令，一条流水线

都支持 --json，stdout 只有结果

hgc search <关键词>

搜剧，给出 series_id、集数与预估价格

--page--limit 10--json
hgc submit <id | 链接 | 口令>

建下载任务；不扣费，返回 job_id 与报价

--episodes 1-20,25--all--json
hgc status <job_id>

进度、失败集、ETA；--watch 阻塞到终态

--watch--interval 3--timeout 1800
hgc link <job_id>

取直链（扣费）；重复取幂等，不重复扣

--yes--zip--json
hgc setup <claude | codex>

写入/移除 Agent 指令段，幂等，可回滚

--project--print--remove
hgc help [命令]

说明书：人读 / Agent 读 / 机器读三种

--agent--json
03

不想装 CLI，就直接调 API

OpenAPI：/api/docs

https://guoshi.app/api/v1/agent Bearer hgc_live_…
GET/manifest版本、限额、CLI 校验和（公开）
GET/search?q=关键词&page=1搜剧 + 预估价格
POST/jobs{ series_id | url, episodes }
GET/jobs/{id}percent / eta / next
POST/jobs/{id}/links{ confirm: true }
GET/whoami账号、余额、Key 权限
401 unauthorized 402 余额不足 409 待确认 429 限流 120 次/分钟 · Key 可随时撤销