SuperAPI AI 工具集

linkedin-search

通用与其它

查看项目

更新于 10-22 16:15

技能介绍

LinkedIn Search Skill 用于从 LinkedIn 公开职位板块搜索实时职位列表,支持任意国家/地区以及远程职位。该技能无需认证、无需 API Key,也没有运行时依赖,仅依靠 bun 运行;位置参数始终显式传入,因此同一技能可在任意市场直接使用。它是仓库中 job-portal-skill 模式的一个与国别无关的示例:LinkedIn 的 jobs-guest 端点在全球通用,HTML 解析与国别无关,只有传入的 --location 会随市场变化。

适用场景:在指定地点(任意国家/城市)或远程搜索职位;按发布时间(今天/最近 7/14/30 天)或工作类型(远程/混合/现场)筛选;获取某条具体职位的完整描述。

使用方式(命令行):

搜索职位: bun run .agents/skills/linkedin-search/cli/src/cli.ts search --location "<place>" [flags]

主要参数: --location <text> / -l <text>:必填,LinkedIn 地点字符串,如 "Mumbai, Maharashtra, India"、"Berlin, Germany"、"London, United Kingdom" 或 "Remote"。 --query <text> / -q <text>:关键词搜索(职位、技能、角色),推荐使用。 --jobage <days>:发布于 N 天内,可选 1、7、14、30;省略表示全部。 --jobage-minutes <n>:发布于 N 分钟内(日内精度,如 30);与 --jobage 冲突,只能传一个。 --remote <mode>:remote、hybrid 或 onsite,即工作类型筛选。 --page <n>:页码(从 1 开始,每页 10 条)。 --limit <n> / -n <n>:限制输出总数(客户端)。 --format json|table|plain:默认 json。

获取职位详情: bun run .agents/skills/linkedin-search/cli/src/cli.ts detail <id|url> [--format json|plain] 其中 id 为搜索结果中的职位 ID(如 4426311357),也可传完整的 LinkedIn jobs/view/... URL 或 urn:li:jobPosting:... URN。返回完整描述、资历、雇佣类型、职能和行业。

示例:

班加罗尔的数据工程师职位,最近 30 天

bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "data engineer" -l "Bengaluru, Karnataka, India" --jobage 30 --format table

柏林的产品经理远程职位

bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "product manager" -l "Berlin, Germany" --remote remote --format table

任意职位,完全远程

bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "paralegal" -l "Remote" --format table

工程师远程职位,最近 30 分钟发布

bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "engineer" -l "Remote" --jobage-minutes 30 --format table

某职位的完整详情

bun run .agents/skills/linkedin-search/cli/src/cli.ts detail 4426311357 --format plain

输出格式:json(默认,适合程序化使用、将 ID 传给 detail)、table(便于人工快速浏览)、plain(阅读单个职位的完整详情)。所有错误以 { "error": "...", "code": "..." } 写入 stderr,进程以退出码 1 结束。

注意事项与限制:数据来自 LinkedIn 公开 jobs-guest 端点,无需凭证;每页固定 10 条结果;LinkedIn 可能限流,CLI 会对 429/5xx 采用指数退避重试,应保持低频率;职位 ID 为数字,原样传给 detail。该技能仅限个人使用:使用 LinkedIn 公开职位页面进行自动化访问违反其服务条款,请保持低量,不得商用或批量数据采集,使用风险自负。