SuperAPI AI 工具集

indeed-research

数据与分析

查看项目

更新于 10-15 20:29

技能介绍

用途:该技能用于搜索 Indeed 职位发布,并按 job key 拉取单条职位的完整详情,全部通过 Crawlora API 返回规范化 JSON,无需手动抓取 indeed.com。

主要能力:地点解析(/indeed/locations/suggest,传入部分地点字符串 q,返回 Indeed 自身的自动补全建议,用于构造有效的 l 值);职位搜索(/indeed/search,q 必填,可选 l、radius、fromage、sort、page,每条结果含 job_key);职位详情(/indeed/job,传入搜索结果中的 16 位十六进制 job key,返回完整职位信息)。

使用方式:先在 https://crawlora.net 获取免费 Crawlora API key(每月 2000 credits,无需信用卡),将 CRAWLORA_API_KEY 设置到环境变量,helper 会读取该变量并向 https://api.crawlora.net/api/v1 发送请求,缺失或无效 key 返回 401。所有请求使用 scripts/crawlora.sh,以避免 API key 出现在命令行参数中。示例:scripts/crawlora.sh /indeed/locations/suggest q="san fran" | jq '.';scripts/crawlora.sh /indeed/search q="staff engineer" l="San Francisco, CA" fromage=7 sort=date | jq '.';scripts/crawlora.sh /indeed/job jk=abcdef0123456789 | jq '.'。完整端点列表见 reference/endpoints.md。

适用场景:按关键词与地点搜索职位、解析有效地点字符串、拉取单条职位完整详情、查找最近 N 天内发布的职位、翻页遍历搜索结果。

限制:仅公开数据,需遵守 Indeed 条款;按成功计费,仅 2xx 计费,免费额度每月 2000 credits;key 只存于 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交到仓库;page 2+ 与 fromage 会回退到较慢的基于页面的传输方式,page 1 且无 fromage 使用 Indeed 快速免凭证 GraphQL API,两种方式返回结构一致;地点自动补全无基于页面的回退,仅支持 GraphQL,可能独立于搜索/详情失败;搜索结果分页,需传 page 遍历完整列表。