用途:从 URL 提取并规范化内容,返回结构化数据(正文、元数据、引用链接),可作为内容生成技能的前置处理,或单独用于内容抓取。触发场景:用户提供 URL 要求提取/阅读内容、其他技能需要解析来源素材、用户说“解析链接”“提取内容”。不适用:已有文本无需解析、生成音视频、读取本地文件。
主要能力:支持 HTTP(S) URL;可选生成摘要(summarize)、限制最大长度(maxLength);针对 Twitter/X 可设置抓取推文数量(1-100,默认 20)。返回 content、metadata(title、author、publishedAt)、references 及消耗积分。
使用方式:需环境变量 LISTENHUB_API_KEY(格式 lh_sk_...,Pro 计划,获取地址 https://listenhub.ai/settings/api-keys)。先读取配置,缺失则静默创建 .listenhub/content-parser/config.json(默认 autoDownload:true)。提交任务:POST https://api.marswave.ai/openapi/v1/content/extract,请求头含 Authorization: Bearer $LISTENHUB_API_KEY、Content-Type: application/json、X-Source: skills,请求体 source.type 为 url、source.uri 为链接。随后轮询 GET /v1/content/extract/{taskId},间隔 5 秒、最多 60 次,状态字段为 .data.status(processing/completed/failed)。完成后若 autoDownload 为真,将 {slug}.md 与 {slug}.json 写入当前目录(不保存到 ~/Downloads/ 或 .listenhub/)。
限制:URL 必须为有效 HTTP(S);不得使用 shell 脚本,需按 API 参考构造 curl;不得记录完整 API 密钥;敏感信息不应作为内容输入。错误码包括 29003 校验错误、21007 无效密钥、25002 任务不存在、25429 限流;HTTP 402 表示积分不足,429 需退避重试,5xx 最多重试 3 次。预计耗时 10-30 秒。其他平台支持范围、具体积分价格等资料暂未提供。