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. 04JSON、表、プレーンテキストでの出力
  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 キーも不要で、実行時の依存関係はゼロ ——bun だけで動作します。ロケーションは常に明示的に指定するため、同じスキルがどの市場のフォーカーでもそのまま使えます。

これは、このリポジトリの 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 分以内に投稿(1 日未満の精度、例: 30)。--jobage と競合するため、どちらか一方のみを指定してください。
  • --remote <mode> — remote、hybrid、または onsite(勤務形態フィルター)。
  • --page <n> — ページ番号(1 始まり、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デフォルト — プログラムでの利用、detail への ID の受け渡し
table人がざっと確認するのに便利
plain1 件の求人の詳細全体を読む(detail コマンド)

すべてのエラーは { "error": "...", "code": "..." } として stderr に書き込まれ、プロセスはコード 1 で終了します。

注意事項

  • データは LinkedIn の公開 jobs-guest エンドポイントからのものです——認証情報は不要です。
  • ページサイズは 1 ページあたり 10 件で固定です。
  • LinkedIn はレート制限を行う場合があります。CLI は 429/5xx を指数バックオフでリトライします。利用量は少なく抑えてください(上記の利用規約の注意を参照)。
  • 求人 ID は数値です(例: 4426311357)——そのまま detail に渡してください。

コメント

Markdown 対応