mcpField
U
upwork-research

upwork-research

github.com/crawlora-org生産性144 回インストール2 日前に更新
リポジトリ

upwork-research について

upwork-researchは、Upworkの公開求人を検索し、求人やフリーランサーの詳細を取得するスキルです。Crawlora APIから正規化されたJSONを受け取り、相場調査や候補者の確認に使えます。

主な機能

  1. 01キーワードによる求人検索
  2. 02求人の詳細情報取得
  3. 03フリーランサーのプロフィールと評価
  4. 04検索結果のページネーション

活用シーン

  1. 01求人予算から相場を推定
  2. 02フリーランサーのスコアと評価を確認
  3. 03応募前に求人の詳細を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill upwork-research

インストール後、Claude Code で/upwork-researchを入力して読み込まれたか確認します。

同梱ファイルreference/endpoints.mdscripts/crawlora.sh

詳細

Upwork リサーチ

Upwork の求人を検索し、フリーランサーのプロフィールを取得します。Upwork のページを手作業でスクレイピングすることなく、すべて Crawlora API から正規化済み JSON として取得できます。

このスキルを使用する場面

  • 「Upwork で <skill/role> の求人を検索して。」— 公開求人情報を対象にしたフリーテキストキーワード検索です。
  • 「この Upwork の求人を見せて。」— ID で指定した求人の詳細（予算、説明、クライアントの履歴）を取得します。
  • 「この Upwork のフリーランサーについて調べて。」— フリーランサー ID でプロフィール、時間単価、Job Success Score、評価、最近のクライアントからのフィードバックを取得します。
  • 「Upwork で の相場はいくら？」— 検索結果から予算を収集して、市場価格を推定します。
  • 「採用前にこのフリーランサーを審査して。」— 1 回の呼び出しでプロフィールとフィードバック履歴を取得します。

セットアップ（一度だけ）

  • https://crawlora.net で無料の Crawlora API キーを取得します（月 2,000 クレジット、カード不要）。
  • ヘルパーを実行する前に、環境変数 CRAWLORA_API_KEY を設定します。
  • ヘルパーは環境変数から CRAWLORA_API_KEY を読み込み、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない場合、または無効な場合は 401 が返されます。

仕組み

  1. 検索 — /upwork/search にフリーテキストキーワード（q）を渡すと、正規化された求人の概要（タイトル、予算、経験レベル、期間、投稿日、説明の抜粋、スキルタグ）が返されます。page を使ってページネーションできます。
  2. 求人の詳細 — 検索結果から id を取得し、/upwork/job/{id} を呼び出すと、求人の詳細が返されます。説明、雇用形態、予算（時間単価の範囲または固定額）、勤務地／リモートの種類、経験レベル、期間、プロジェクトの種類、提案数、応募可能な国、掲載クライアントの概要（Upwork の登録時期、所在地、支出額、採用数、勤務時間、業界、企業規模）が含まれます。
  3. フリーランサーのプロフィール — /upwork/freelancer/{id} は正規化されたプロフィールを返します。氏名、肩書き、認証バッジ、概要、時間単価、評価とレビュー数、Job Success Score、所在地と現地時刻、累計の仕事数／勤務時間、最近のクライアントからのフィードバック（タイトル、コメント、日付、クライアント名、評価）が含まれます。

エンドポイント、メソッド、パラメーターの一覧は、reference/endpoints.md を参照してください。

API の呼び出し

# Search jobs by keyword:
scripts/crawlora.sh /upwork/search q="react developer" | jq '.'

# Job detail (id from a search result):
scripts/crawlora.sh /upwork/job/<job_id> | jq '.'

# Freelancer profile (id from a search result or a known profile):
scripts/crawlora.sh /upwork/freelancer/<freelancer_id> | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用してください。API キーがコマンドライン引数に含まれないようにできます。

エンドポイントリファレンス

このスキルで使用する Upwork の全エンドポイントについては、reference/endpoints.md を参照してください。

使用例

  • フリーランスの相場確認： あるスキルについて /upwork/search を実行し（例：q="react developer"）、検索結果から budget フィールドを収集して、そのスキルの市場価格を推定します。
  • フリーランサーの採用前調査： /upwork/search または既知の ID で候補者を見つけてから、/upwork/freelancer/{id} で Job Success Score、時間単価、勤務時間、最近のクライアントからのフィードバックを確認してから連絡します。

注意事項と制限

  • クレジット／成功時のみ課金： 2xx の場合にのみ課金されます。無料プランは月 2,000 クレジットです。キーは https://crawlora.net から取得できます。
  • 公開データのみ — 公開されている求人とプロフィールのみです。Upwork の利用規約を遵守してください。
  • セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。ハードコード、クエリパラメーターへの指定、コミットはしないでください。
  • 求人とフリーランサーの ID は検索結果から取得します — ID を推測せず、/upwork/search の出力から id フィールドを取得してください。
  • データは、実際のブラウザーレンダリングバックエンドを介して Upwork 自身のサーバー側でレンダリングされたページから取得されます。そのため、各フィールドにはページ上で公開されている情報がそのまま反映されます（Upwork のログイン画面の先にあるデータは含まれません）。
  • /upwork/search はページネーションに対応しています。最初のページ以降の結果を取得するには page を渡してください。

コメント

Markdown 対応