glassdata

glassdata

glassdata は、JSON として Glassdoor の求人データを返す、ホスト型 HasData Glassdoor MCP サーバーへの小規模なローカルブリッジです。場所とキーワードを指定して求人情報を検索したり、求人 URL から掲載情報の全内容を取得したりできます。取得できるのは、職種名、企業名とその評価、勤務地、給与の推定額、掲載日、説明文全文、記載されている応募資格と福利厚生です。

このブリッジは求人情報を独自に保持しません。ライブエンドポイントから取得したとおりに、ツール一覧への応答はローカルで返し、各ツール呼び出しは上流へ転送して、返ってきた内容をそのまま返します。取得したインターフェースは、公開求人情報を読み取るだけの 2 つのフェッチ機能です。応募の送信、雇用主や候補者の連絡先データ、メッセージ機能や決済ツールは含まれていません。

ツール

• hasdata_glassdoor_listing_getJobListings — Glassdoor の求人情報を検索します。必須項目：keyword と location。任意項目：sort（recent / relevant）、検索対象とする国別 Glassdoor サイトを指定する domain、指定日数以内に掲載された求人に絞る datePosted、検索距離（マイル）を指定する radius、年間給与範囲を指定する minSalary と maxSalary、企業評価の下限を指定する minRating、easyApplyOnly と remoteOnly のフラグ、ページ送り用の nextPageToken（トークンには元の検索フィルターが含まれます）。職種名、企業名、勤務地、給与の推定額、掲載日、求人 URL、jobId と、ページごとのトークンを含む求人情報を返します。
• hasdata_glassdoor_job_getJobDetails — 1 件の求人情報の全内容を取得します。必須項目：url（求人 URL）。職種名、企業名と評価、勤務地、給与の推定額、掲載日、説明文全文、応募資格と福利厚生を返します。

設定

• HASDATA_GLASSDOOR_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://mcp.hasdata.com/mcp?apis=glassdoor です。（上書き用の仕組みは、この再構築で独自に再現したものとして明記しています。）
• HASDATA_API_KEY（任意）— 設定すると、上流へのすべてのリクエストに、呼び出し元自身の HasData API キーを指定する x-api-key: <key> ヘッダーが付加されます。設定されていない場合、キーのヘッダーは送信されません。（ヘッダー名と環境変数名は元のレジストリ記録に基づいており、この環境変数からキーを転送する機能は、元のインターフェースがキーなしで取得されていたため、この再構築で独自に再現したものとして明記しています。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開始します。まず JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、clientInfo name glassdata）を送信し、次に notifications/initialized 通知を送信してから、呼び出し元の引数を変更せずに含めた tools/call リクエストを送信します。上流が initialize に Mcp-Session-Id ヘッダーを付けて応答した場合、その値は以降のセッション内のすべてのリクエストに付加され、プロセスの終了までセッションが再利用されます。応答は通常の JSON またはサーバー送信イベントとして届く場合があり、どちらも読み取ります。

上流からの成功結果は、上流が設定した isError フラグも含め、そのまま渡されます。失敗（JSON-RPC エラー、2xx 以外のステータス、読み取れない応答、完了できないリクエスト）は、テキストが glassdata error: で始まる isError 結果として返されます（このエラー表示は、この再構築で独自に再現したものとして明記しています）。

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドとしても実行できます。

npx @reneturcios/glassdata hasdata_glassdoor_listing_getJobListings '{"keyword":"software engineer","location":"San Francisco, California"}'
npx @reneturcios/glassdata hasdata_glassdoor_job_getJobDetails '{"url":"https://www.glassdoor.com/job-listing/example"}'
npx @reneturcios/glassdata --version

終了コード：成功時は 0、isError 結果の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/glassdata mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "glassdata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/glassdata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/glassdata
docker run --rm ghcr.io/cloudcorprecords/glassdata --version

コンテナのデフォルトコマンドは mcp です。そのため、最初の形式は stdio MCP サーバーとして動作します。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべてスタブ化された JSON-RPC 上流を相手に実行され、実ネットワークへの呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。