SuperAPI AI 工具集

linkup-extract

数据与分析

查看项目

更新于 10-16 10:18

技能介绍

用途 Linkup Extract 用于把已知的单个网页转换成结构化的记录表格。它面向的是单个列表页的批量提取需求,例如团队目录、产品与定价目录、职位列表、会议演讲者,以及需要分页抓取的页面。官方定位是处理来自一个列表页的十到数千条记录。

主要能力 调用时提供一个种子 URL,并用自然语言描述想要的行数据;接口会自动处理分页,最终返回 NDJSON(每行一个 JSON 对象)。接口也支持传入 schema 以约束输出结构。对于提取出的 URL,如果下游会使用,可以启用 verifyUrls,但会增加延迟。

使用方式 该技能使用 REST API,因此需要 LINKUP_API_KEY 环境变量: test -n "$LINKUP_API_KEY" || echo "Missing LINKUP_API_KEY"

调用示例: curl -sS -X POST "https://api.linkup.so/v1/extract"
-H "Authorization: Bearer $LINKUP_API_KEY" -H "Content-Type: application/json"
-d '{ "q": "All pricing plans with plan name, monthly price, annual price, features, and usage limits", "url": "https://competitor.com/pricing", "schema": {"type":"object","properties":{"planName":{"type":"string"},"monthlyPrice":{"type":"string"},"annualPrice":{"type":"string"},"features":{"type":"array","items":{"type":"string"}}}} }'

异步流程 POST /v1/extract 返回 {id, status: "pending"}。需要用 GET /v1/extract/{id} 轮询,官方建议约每 30 秒一次,因为抓取比研究耗时更长。任务完成后,输出中会包含一个 resultUrl(24 小时过期),下载后按行解析 JSON 对象即可。

如果还不知道目标 URL,可以先用 linkup-search 发现(例如查找某公司的招聘页面 URL),再用提取从结果页获取数据。

适用场景 适合:只有一个 URL、但需要大量结构化行(团队、目录、职位、演讲者)。 不适合:只想获取一个页面的正文或 Markdown(应使用 linkup-fetch);需要跨网络查找信息(应使用 linkup-search);需要跨多个来源做综合研究(应使用 linkup-research)。

限制 需要 LINKUP_API_KEY。异步任务需要轮询,结果文件有 24 小时有效期。启用 verifyUrls 会增加延迟。更多参数、模式与定价说明见该技能目录下的 references/LINKUP_SPECIALIZED_ENDPOINTS.md 的 Extract 部分。