ashby-jobs

🟣 Ashby 求人ボード API：求人、企業、給与データ

Apify 上の Ashby 求人ボード API をすぐに使い始めるための Python および MCP ガイドです。Ashby がホストする任意のボードから求人情報をスクレイピングし、Ashby を利用している企業を探したり、企業がボードを持っているかどうかを確認したり、各行に雇用主自身が公開している給与範囲を取得したりできます。API キーもログインも必要ありません。

• Actor：Apify 上の Ashby Job Board API
• 入力スキーマ：入力パラメーター
• 無料 API トークンを取得：apify.com

Ashby は、OpenAI、Ramp、Notion、Linear、Cerebras など、急成長する多くの企業の採用ページを支える ATS です。この Actor は、実行時にすべての jobs.ashbyhq.com ボードで使用されている公開 API を読み取るため、各行には先週インデックスが記録した情報ではなく、雇用主のボードに現在掲載されている内容が反映されます。企業名、ボードスラッグ、または URL を指定するか、何も指定せず、収録されている 2,700 件以上の検証済みボードのディレクトリを一括検索できます。

テキストガイド

Ashby 求人ボード API は、企業名（「Black Semiconductor」）、ボードスラッグ（cerebras）、または jobs.ashbyhq.com の任意の URL を受け取り、構造化された求人情報の行を返します。各行には、title、companyName、department、team、employmentType、workplaceType、isRemote、location、countriesDerived、datePublished、compensationSummary、CSV ですぐに使える salaryMin／salaryMax／salaryCurrency／salaryPeriod の個別列、offersEquity フラグ、そしてデフォルトでは Markdown 形式の説明が含まれます。publishedAfter に 25h のような期間を設定すると、その期間内に追加された求人のみが返されます。これにより、「Ashby の新規求人を毎日追跡する」タスクでは、状態管理なしで新しい求人のフィードを作成できます。outputMode を companiesOnly に切り替えると、Ashby 経由で採用している企業ごとに 1 行が返され、現在の募集中の求人件数も確認できます。Ashby を利用している企業を探す最も手軽な方法です。フィルターは課金前に適用されるため、フィルターで除外された求人には料金がかかりません。

クイックスタート

前提条件：Python 3.11 以降、uv、および apify.com で取得できる無料の Apify API トークン。

git clone https://github.com/johnisanerd/Apify-Ashby-Job-Board-API.git
cd Apify-Ashby-Job-Board-API
uv sync
cp .env.example .env          # paste your token into .env
uv run python ashby-job-board-api-example.py

各例は個別のフラグです。

uv run python ashby-job-board-api-example.py --example jobs       # full job records
uv run python ashby-job-board-api-example.py --example companies  # company discovery
uv run python ashby-job-board-api-example.py --example check      # does this company use Ashby?
uv run python ashby-job-board-api-example.py --example new-jobs   # new-postings feed
uv run python ashby-job-board-api-example.py --example markdown   # LLM-ready descriptions
uv run python ashby-job-board-api-example.py --example salary     # postings with pay data
uv run python ashby-job-board-api-example.py --example all

各例では、意図的に少数の行だけを取得します。料金は返された行数に応じて発生するため、まずデータの形式を確認してから maxJobs を増やしてください。

この API を使う理由

インデックスではなく、最新情報です。 公開 API にボードごとに 1 回リクエストするため、各行には雇用主のボードに現在掲載されている内容が反映されます。古いインデックスも、掲載されていない求人もありません。

基本の行に給与データを含みます。 Ashby を利用する雇用主は、構造化された報酬情報を公開しています。すべての求人行には、生データの構造（salaryRaw）、正規化された範囲（salaryDerived）、CSV 用の salaryMin／salaryMax／salaryCurrency／salaryPeriod の個別列、ティアごとの範囲（salaryTiers）、および offersEquity フラグが含まれます。

「もしかして」候補付きの企業検索。 知っている企業名を入力すると、Actor がボードスラッグに自動で照合します。見つからない場合は、最も近い既知のスラッグを示す、わかりやすい未検出の行を返します。

企業の発見機能を内蔵。 2,700 件以上の検証済み Ashby ボードを収録したディレクトリにより、companiesOnly モードと空の入力での一括検索を利用できます。ディレクトリと最新情報の読み取りを 1 つのツールに統合しているのは、このツールだけです。

状態管理なしで新着求人を取得。 Ashby の求人にはすべて雇用主自身が設定した公開日時が含まれるため、毎日のスケジュールで publishedAfter: "25h" を指定すれば、新着求人の完全なフィードを取得できます。既読リストも差分ストアも必要ありません。

受け取った分だけ支払います。 開始料金も最低料金もありません。基本の求人レコードは給与データ込みで 1 イベントとして扱われます。Markdown、HTML、テキスト、企業データの拡充、実行レポートは追加オプションで、該当データが含まれる行に対してのみ課金されます。

レシピ

それぞれ専用の Store ランディングページがある、すぐに使える設定です。

• Ashby ATS を使用している企業を検索する
• 給与データ付きで Ashby の求人をスクレイピングする
• Ashby の新着求人を毎日追跡する
• AI エージェント向けに Ashby の求人を Markdown 形式で取得する
• 企業に Ashby の求人ボードがあるか確認する

スケジュール設定のヒント。 入力を Apify Console でタスクとして保存し、publishedAfter を 25h に設定して、毎日実行するようスケジュールします。以降、データセットには前回の実行後に追加された求人のみが含まれるため、誰も手を加えなくてもパイプラインを最新の状態に保てます。

使用例

デフォルト実行に一致する基本的な例：

{
  "companies": ["cerebras", "ramp"],
  "titleKeywords": ["engineer"],
  "maxJobs": 10
}

企業データのエンリッチメントとレポートを含む、リモート職向けの高度な例：

{
  "companies": ["openai", "ramp", "deel"],
  "remoteOnly": true,
  "employmentTypes": ["FullTime"],
  "includeCompanyData": true,
  "report": "markdown",
  "maxJobs": 100
}

入力パラメーター

すべてのパラメーターは省略可能です。

パラメーター	型	デフォルト	説明
companies	array	["cerebras"]	企業名、求人ボードのスラッグ、または求人ボード、埋め込み、単一求人の各 URL を自由に組み合わせて指定します。空の場合は、同梱のディレクトリ全体を検索します。
startUrls	array	空	URL リスト形式で同じ値を指定します。companies とマージされます。
outputMode	string	jobs	完全なレコードには jobs、簡易インデックスには urlsOnly、企業の検出には companiesOnly を指定します。
discoveryQuery	string	空	企業ディレクトリ内のテキスト検索に使用します。企業の検出と一括検索に適用されます。
verifyCompanies	boolean	true	検出した各企業をライブプローブします。無効な求人ボードには課金されません。
titleKeywords	array	空	タイトルにこれらのいずれかが含まれる求人のみを残します。課金前に適用されます。
departments	array	空	一致する部門またはチームの求人のみを残します。
locationKeywords	array	空	一致する勤務地または住所の求人のみを残します。
employmentTypes	array	空	次の種類のみを残します：FullTime、PartTime、Intern、Contract、Temporary。
remoteOnly	boolean	false	求人ボードでリモート勤務と表示されている求人のみを残します。
publishedAfter	string	空	新着求人を取得します：24h、7d、2w、または ISO 日付。
includeDescriptionMarkdown	boolean	true	説明を Markdown 形式で追加します（有料アドオン）。
includeDescriptionHtml	boolean	false	元の HTML を追加します（有料アドオン）。
includeDescriptionText	boolean	false	求人ボードのプレーンテキストを追加します（有料アドオン）。
includeCompanyData	boolean	false	求人ページから行データをエンリッチします：企業のウェブサイト、ロゴ、リモート勤務可能な国、締切日、直接応募（有料アドオン）。
report	string	none	Markdown または HTML 形式の実行レポートをキーバリューストアに書き込みます（有料アドオン）。
maxCompanies	integer	25	一括検索と検出における企業数の上限です。
maxJobsPerCompany	integer	0	求人ボードごとの上限です。0 はすべてを意味します。
maxJobs	integer	100	実行全体の上限です。主なコスト管理項目です。
maxConcurrency	integer	5	検出とエンリッチメントのリクエストを並列処理する数です。
proxyConfiguration	object	direct	任意の Apify Proxy 設定です。直接接続も使用できます。

出力形式

完全な求人レコード：

{
  "resultType": "job",
  "id": "34413f8d-26bf-4bbc-8ade-eb309a0e2245",
  "title": "Security Engineer, Cloud",
  "companyName": "Ramp",
  "boardToken": "ramp",
  "url": "https://jobs.ashbyhq.com/ramp/34413f8d-26bf-4bbc-8ade-eb309a0e2245",
  "applyUrl": "https://jobs.ashbyhq.com/ramp/34413f8d-26bf-4bbc-8ade-eb309a0e2245/application",
  "department": "Engineering",
  "team": "Backend",
  "location": "New York, NY (HQ)",
  "countriesDerived": ["United States", "Canada"],
  "isRemote": true,
  "workplaceType": "Hybrid",
  "employmentType": "FullTime",
  "datePublished": "2026-04-07",
  "compensationSummary": "$211.4K - $290.6K",
  "salaryMin": 211400,
  "salaryMax": 290600,
  "salaryCurrency": "USD",
  "salaryPeriod": "year",
  "offersEquity": true,
  "descriptionMarkdown": "# About Ramp\n\nRamp is building...",
  "source": "ashby",
  "scrapedAt": "2026-08-27T16:00:00Z"
}

検出された企業の行：

{
  "resultType": "company",
  "boardToken": "ramp",
  "boardUrl": "https://jobs.ashbyhq.com/ramp",
  "companyName": "Ramp",
  "jobCount": 135,
  "live": true,
  "verifiedAt": "2026-08-27T16:00:00Z"
}

🤖 このアクターについてAIアシスタントに質問する

お好みのAIで、Ashby Job Board APIについてすぐに送信できるプロンプトを開きます。

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

よく一緒に検索される質問

これはAshbyスクレイパーですか？

内部では、スクレイパーが使うものと同じ公開エンドポイントを読み取ります。利用できるのはAPIで、必要なときに取得できる構造化JSON、フィルター、安定したフィールド名を備え、指定しない限りHTMLは返しません。Ashbyの求人ボードを独自にスクレイピングして管理している場合、これはパーサーの保守を他の人に任せられるバージョンです。

jobs.ashbyhq.comとは何ですか？

Ashbyが顧客の公開求人ボードをホストしているドメインです。Ashbyを利用している各企業には、jobs.ashbyhq.com/companynameにページがあります。そのURLをボード全体または個別の求人を指定してこのアクターに貼り付けると、ページの背後にある構造化データが返されます。

Ashby APIキーは必要ですか？

いいえ。Ashbyの認証済みAPIは雇用主向けです。このアクターは公開求人情報のレイヤーのみを使用するため、登録は不要です。

Ashbyを利用している企業を見つけるにはどうすればよいですか？

outputModeをcompaniesOnlyに設定します。企業ごとに1行が返され、ボードのスラッグ、現在の公開求人件数、ボードURLが含まれます。--example companiesスクリプトでこれを実行でき、--example checkでは特定の名前のリストを確認できます。

Ashbyの給与データを取得するにはどうすればよいですか？

基本行に含まれています。報酬を公開している雇用主は、構造化された範囲を掲載しています。これらはsalaryMin／salaryMax／salaryCurrency／salaryPeriodの各列とoffersEquityとしてフラットな形式で取得でき、元の構造はsalaryRawに格納されています。--example salaryスクリプトを実行すると、給与テーブルが表示されます。

新しい求人情報のみを取得するにはどうすればよいですか？

publishedAfterに24hのような期間、またはISO日付を設定します。このアクターは雇用主独自の公開タイムスタンプを使用するため、実行間で状態を管理する必要はありません。

PythonからAshby求人ボードAPIを使うにはどうすればよいですか？

このリポジトリをクローンし、uv syncを実行して、.envにApifyトークンを設定し、サンプルを実行します。rows()ヘルパーで、アクターを呼び出してからデータセットを反復処理する一連の流れを確認できます。

Claude Cowork デスクトップにインストールする

Cowork はデスクトップアプリの自動化モードです。Ashby Job Board API をツールとして利用できるようにするには、Apify MCP サーバーをコネクターとして追加します。

1. Claude デスクトップアプリを開き、設定 → コネクターに移動します（または、claude_desktop_config.json を直接編集するには設定 → 開発者 → 設定を編集に移動します）。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. この Actor のみを事前読み込みした Apify MCP サーバーを追加します。

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/ashby-job-board-scraper"
      ]
    }
  }
}

3. アプリを再起動します。Cowork が初めてツールを呼び出す際に、ブラウザーで OAuth プロンプトを完了するか、OAuth を省略するためにコネクターの設定に Apify API トークンを追加します。
4. Cowork のチャットでツールが利用可能であることを確認し、Ashby Job Board API の実行を依頼します。

デスクトップアプリをダウンロードして、無料トライアルを始めましょう：https://claude.ai/referral/uIlpa7nPLg 詳しい説明：https://docs.apify.com/platform/integrations/claude-desktop

---

Claude Code にインストールする

Claude Code はコマンドラインツールです。次のコマンドで Actor の MCP サーバーを追加します。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/ashby-job-board-scraper"

ブラウザーでの OAuth の代わりにトークンを使用するには、次のようにします。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/ashby-job-board-scraper" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

その後、claude mcp list で確認するか、セッション内で /mcp を実行します。Claude Code に Ashby Job Board API の呼び出しを依頼します。

Claude Code を無料でお試しください：https://claude.ai/referral/uIlpa7nPLg Claude Code MCP ドキュメント：https://code.claude.com/docs/en/mcp

---

Claude（ウェブサイト）にインストールする

claude.ai では、Apify をコネクターとして追加してから、この Actor のツールだけを有効にします。

1. 設定 → コネクター → コネクターを参照に移動し、Apify MCP serverを検索します。インストールします（求められた場合は有効化または更新します）。
2. 接続時に Apify API トークンで認証し、ツール johnvc/ashby-job-board-scraper を有効にします。
3. 任意のチャットで + → コネクターを開き、Apifyをオンにします。
4. または、カスタムコネクターを追加を選択し、完全な MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/ashby-job-board-scraper を貼り付けます。プロンプトが表示されたら OAuth を使用します。
5. Claude に Ashby Job Board API の実行を依頼します。

ウェブで Claude を開く：https://claude.ai

---

Cursor にインストールする

Cursor は、プロジェクトファイル .cursor/mcp.json から MCP サーバーを読み込みます。

1. プロジェクト内に .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/ashby-job-board-scraper"
    }
  }
}

2. ブラウザーでの OAuth の代わりにトークン認証を使用する場合は、ヘッダーを追加します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/ashby-job-board-scraper",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor → 設定 → MCPを開き、apifyサーバーが接続されていること（緑色の点）を確認します。
4. Composer または Chat で、Cursor に Ashby Job Board API の呼び出しを依頼します。

Cursor を初めてお使いですか？こちらから入手できます：https://cursor.com/referral?code=XQP4VBLI3NNX

---

ChatGPT にインストールする

ChatGPT は Developer mode を通じて Apify MCP サーバーに接続します（ChatGPT Pro、Plus、Business、Enterprise、Education の各プランで利用できます）。

1. プロフィールアイコンをクリックし、Settings > Apps に移動します。Create app ボタンが表示されない場合は、Advanced settings を開いて Developer mode を有効にします。
2. Create app をクリックして、フォームに入力します。
   • Name: Apify
   • MCP Server URL: https://mcp.apify.com/?tools=actors,docs,johnvc/ashby-job-board-scraper
   • Authentication: OAuth
3. Create をクリックし、Apify との接続を承認します。
4. 会話でアプリを使用するには、チャットの + をクリックし、Developer mode を選択してから Apify を選びます。

詳しくはこちら：https://docs.apify.com/platform/integrations/mcp

---

Apify の johnvc が心を込めて作成しました。

最終更新日：2026.10.27