indeed-research

Indeed 求职搜索

按关键词和地点搜索 Indeed 职位，使用自动补全解析有效的地点字符串，并获取单个职位的完整详情——所有数据均以 Crawlora API 返回的标准化 JSON 格式提供，无需手动抓取 indeed.com。

何时使用此技能

• “在 Indeed 上搜索 在 的职位。”
• “<partial city/area> 对应的 Indeed 正确地点字符串是什么？”
• “获取这个 Indeed 职位的完整详情（职位键 ）。”
• “查找 Indeed 上最近 N 天内发布的 职位。”
• “翻页浏览 Indeed 上 的搜索结果。”

设置（一次性）

• 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 个积分，无需信用卡）。
• 运行辅助程序前，在环境中设置 CRAWLORA_API_KEY。
• 辅助程序从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。缺少或无效的密钥 → 401。

工作原理

1. 解析地点（可选，但建议使用） — /indeed/locations/suggest 接受不完整的地点字符串（q），并返回 Indeed 自己的自动补全建议，也就是应用搜索栏提供的相同建议，这样你就可以据此构建有效的搜索 l 值，而不必猜测。
2. 搜索 — /indeed/search 接受关键词（必填的 q）以及可选参数 l（地点）、radius、fromage（仅搜索最近 N 天内发布的职位）、sort（relevance 或 date）和用于分页的 page。每条结果都包含一个 job_key，可用于获取完整详情。
3. 职位详情 — /indeed/job 接受 jk（搜索结果中的 16 位十六进制职位键），并返回完整职位信息。

完整的端点列表、方法和参数：reference/endpoints.md。

调用 API

# Resolve a location string:
scripts/crawlora.sh /indeed/locations/suggest q="san fran" | jq '.'

# Search:
scripts/crawlora.sh /indeed/search q="staff engineer" l="San Francisco, CA" fromage=7 sort=date | jq '.'

# Job detail (jk from a search result):
scripts/crawlora.sh /indeed/job jk=abcdef0123456789 | jq '.'

所有请求均使用 scripts/crawlora.sh；它可以避免将 API 密钥暴露在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有 Indeed 端点。

示例

• 按职位搜索并使用模糊地点： 对用户提供的大致城市名称调用 /indeed/locations/suggest，获取有效的 l 值，然后使用该值以及 q 和 sort=date 调用 /indeed/search，优先获取最新发布的职位。
• 丰富搜索结果： 运行 /indeed/search，从任意一条结果中提取 job_key，然后调用 /indeed/job，获取该职位的完整描述、薪资和申请详情。

说明与限制

• 积分／成功后计费： 仅对 2xx 响应计费；免费套餐每月 2,000 个积分。 密钥可在 https://crawlora.net 获取。
• 仅限公开数据 — 仅获取公开的 Indeed 职位信息；请遵守 Indeed 的条款。
• 安全性： 密钥仅存放在 CRAWLORA_API_KEY 中——切勿硬编码、放入查询参数或提交到代码仓库。
• page 为 2 或更大，或使用 fromage 时，会回退到较慢的基于页面的传输方式 — page 为 1 且未指定 fromage 时，会使用 Indeed 快速且无需凭据的 GraphQL API； 请求第 2 页及之后的页面，或按 fromage 筛选时，会切换传输方式，但两种方式返回的数据都具有相同的标准化结构。
• 地点自动补全没有基于页面的回退方式 — /indeed/locations/suggest 仅支持 GraphQL，因此可能独立于搜索／职位详情请求而失败。
• /indeed/search 的结果采用分页方式 — 传入 page 即可遍历完整列表。