mcpField
L
linkedin-search

linkedin-search

github.com/ai-job-search-dev生产力67.2k267 次安装1 天前更新
代码仓库

关于 linkedin-search

linkedin-search 是基于 Bun 的技能，可搜索不同地区的 LinkedIn 公开职位并获取职位详情。它面向个人低频求职搜索，无需凭据或运行时依赖。

主要功能

  1. 01按地点和关键词搜索职位
  2. 02按发布时间和工作方式筛选
  3. 03获取完整职位描述
  4. 04以 JSON、表格或纯文本输出
  5. 05重试限流及服务器错误

适用场景

  1. 01查找某个城市或国家的近期职位
  2. 02搜索远程或混合办公岗位
  3. 03查看特定职位的要求

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ai-job-search-dev/ai-job-search --skill linkedin-search

安装后在 Claude Code 中输入/linkedin-search确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

url-reference.md
cli/
package.json
README.md
tsconfig.json
cli/src/
cli.ts
helpers.ts
cli/src/commands/
detail.ts
search.ts
cli/tests/
cli-flag-validation.test.ts
detail-description-cli.test.ts
detail-input.test.ts
helpers.ts
parsing.test.ts
remote-mode.test.ts
request-timeout.test.ts
required-query-value.test.ts
retry-backoff.test.ts
search.test.ts
cli/tests/fixtures/
detail-orbis-excerpt.html
README.md
search-cards.json
search-cards.provenance.md

详细介绍

LinkedIn 搜索技能

从 LinkedIn 的公开职位板搜索任意国家/地区（以及远程）的实时职位列表。无需身份验证，无需 API key，且零运行时依赖——只需 bun 即可运行。位置始终显式传入，因此同一技能开箱即适用于任何市场的 fork 者。

这是本仓库 job-portal-skill 模式的一个与国家无关的完整示例。 LinkedIn 的 jobs-guest 端点是全球通用的，HTML 解析与国家无关； 只有你传入的 --location 会因市场而异。

⚠️ 仅供个人使用

本工具使用 LinkedIn 的公开职位页面；自动化访问违反 LinkedIn 的服务条款，因此请保持低频率，不要将其用于商业用途或批量数据收集。 使用风险自负。

何时使用此技能

  • 搜索指定位置（任意国家/城市）或远程的职位空缺
  • 按发布时间（今天 / 最近 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 是来自 search 结果的职位 ID（例如 4426311357）。你也可以传入完整的 LinkedIn jobs/view/... URL 或 urn:li:jobPosting:... URN。返回完整描述、 资历、雇佣类型、职能和行业。

使用示例

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

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

# Any role, fully remote
bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "paralegal" -l "Remote" --format table

# Engineer roles, remote, posted in the last 30 minutes
bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "engineer" -l "Remote" --jobage-minutes 30 --format table

# Full details for a specific job
bun run .agents/skills/linkedin-search/cli/src/cli.ts detail 4426311357 --format plain

输出格式

格式最适合
json默认——程序化使用，将 ID 传给 detail
table快速人工阅读浏览
plain阅读单个职位的完整详情（detail 命令）

所有错误都会以 { "error": "...", "code": "..." } 的形式写入 stderr，并且进程以退出码 1 结束。

说明

  • 数据来自 LinkedIn 的公开 jobs-guest 端点——无需凭据。
  • 页面大小固定为每页 10 条结果。
  • LinkedIn 可能会限流；CLI 会以指数退避重试 429/5xx。请保持低频率（参见上文的 ToS 说明）。
  • 职位 ID 为数字（例如 4426311357）——原样传给 detail。

评论

支持 Markdown