openradar

openradar

openradar は、求人とフリーランス案件を集めたオープンな基盤です。パーサー、ノード、ユーザーが求人掲示板、RSS フィード、Telegram チャンネル、メール通知から投稿を追加します。ハブは重複を統合し、整理されたフィードを維持します。

求職者がパーサーのサブスクリプションや求人への応募に料金を支払う必要はありません。openradar に有料プランはありません。連絡先は投稿に記載されており、クライアントに直接連絡できます。誰でも自分の環境で動かせます。

ライブハブ： openradar.fun

できること

• あらゆる職種をまとめたフィード。 FL.ru、Kwork、Freelancehunt、Habr Career、hh.ru、Работа России、We Work Remotely、Jobicy、RemoteOK、Telegram チャンネル（公開チャンネル、個人アカウント経由の非公開チャンネルやチャット）に対応しています。開発、デザイン、動画、執筆、広告、営業など、幅広い分野をカバーします。2つの掲示板に掲載された投稿も、1件の案件として扱います。
• 検索、フィルター、スコア。 最低予算、スキル、リモートのみ、言語で絞り込み、新着順、おすすめ順、予算の高い順に並べ替えられます。各案件には、報酬、スキル、詳細度、直接連絡先に基づいて0～100のスコアが付与されます。
• ブラウザー拡張機能。 一度 GitHub でサインインすれば、どのサイトからでもワンクリックで求人や案件を追加できます。また、同様の仕事の通常の報酬を表示し、そのページの報酬が相場より低いか、範囲内か、高いかも示します。
• 投票と投稿。 サインインしたユーザーは、案件を有用、スパム、詐欺、終了済みとしてマークしたり、リンクから投稿を追加したりできます。
• 市場調査。 openradar.fun/research：職種、等級、言語、都市、スキル別に、求人の報酬と案件の予算を中央値、四分位数、サンプル数とともに確認できます。月次レポートは引用できるように固定されます。データは CC BY 4.0 の下で公開されています（CSV、JSON）。集計方法：方法論。
• 任意の検索クエリーに対応した RSS、HTTP API、同じフィードを提供する MCP サーバー。
• 自分のノード。 自宅やサーバーで動かし、ソース、フィルター、通知（Telegram、Webhook）を設定できます。ソースを共有しない限り、情報がノードの外に送信されることはありません。

ネットワーク

ノードやパーサーは、投稿を共有ハブに送信できます。すべての投稿には、参加者の鍵で署名が付けられます。ハブは異なる場所で見つかった同じ投稿を統合し、最初に見つけた人にクレジットを付与します。また、投票と報告した参加者の評価に基づき、スパムや詐欺の重みを下げます。

案件を送信した人は、フィードをより早く確認できます。

ティア	条件	遅延	連絡先
ゲスト	サインインしていない	12 h	非表示
メンバー	GitHub でサインイン、または評価 1 以上	3 h	表示
アクティブ	30日間の評価 10 以上	30 min	表示
コア	評価 50 以上、またはモデレーター	なし	表示

評価は、最初に確認した案件（非公開チャンネルおよび6時間の独占掲載は×1.5）、確認、および結果と一致したシグナルに基づいて決まります。スパムまたは詐欺として非表示にされた案件は、ポイントが差し引かれます。詳細：docs/PROTOCOL.md。

クイックスタート

Node.js 22.19+ および pnpm 11+：

git clone https://github.com/MikhailSagalaev/openradar.git
cd openradar
pnpm install
pnpm dev serve

serve を実行すると、一時的な管理者トークンが表示されます。http://127.0.0.1:8787 を開き、そのトークンでサインインして、ソースに移動し、人気の求人掲示板を読み込むを押してください。掲示板がすぐにポーリングされ、数秒以内に最初の案件が表示されます。

DATABASE_URL が設定されていない場合、ノードはすべてのデータをメモリ内に保持します。データを永続化するノードには、Docker を通じて PostgreSQL 17 を使用してください。

cp .env.example .env    # set RADAR_ADMIN_TOKEN, POSTGRES_PASSWORD, DATABASE_URL
docker compose run --rm radar migrate
docker compose up -d

.env.example のサンプルシークレットを使うと、docker compose は起動を拒否します。

パーサーの接続

任意のスクリプト（プライベートチャンネル用の Telethon リーダー、Playwright スクレーパー、cron ジョブ）から、投稿をノードに送信できます。

pnpm dev source add --kind webhook --title "My parser"   # prints the source id and token
python my_parser.py | pnpm dev push --source <id>        # NDJSON, one post per line
# or over HTTP: POST /api/v2/ingest/<id> with the header x-radar-token

または、Python SDK（標準ライブラリのみ。Telethon と Pyrogram のヘルパーを含む）を使って、ハブに直接送信できます。

pip install "git+https://github.com/MikhailSagalaev/openradar#subdirectory=sdk/python"

import os
from openradar import HubClient, Key

hub = HubClient("https://openradar.fun", Key.from_string(os.environ["RADAR_KEY"]))
hub.observe([{"source": {"platform": "telegram", "channel": "-1001234567890", "visibility": "private", "message_id": "48213"},
              "text": "Ищем React-разработчика..."}])

RADAR_KEY は参加者キー（pnpm dev key）で、評価はこのキーに紐付けられます。TypeScript パッケージも同じ HubClient と NodeClient をエクスポートします。

ドキュメント

ドキュメント	内容
GETTING_STARTED.md	シナリオ：ハブの閲覧、ノードの実行、サーバー、パーサー、ハブとの共有
PROTOCOL.md	radar/2：投稿、署名、統合、ティア、評価、モデレーション
ARCHITECTURE.md	ノードのパイプライン、スコア、データモデル、HTTP ルート
PLUGINS.md	ソースまたはシンクアダプターの作成
EXTENSION.md	ブラウザー拡張機能と市場の推定
BACKUP_AND_RESTORE.md	バックアップ
sdk/python	Python SDK

貢献

新しい掲示板の追加は、最も役立つ貢献です。アダプターを 1 つ、フィクスチャを 1 つ、テストを 1 つ追加してください。CONTRIBUTING.md をご覧ください。脆弱性は非公開で報告してください：SECURITY.md。

ライセンス

AGPL-3.0。LICENSE をご覧ください。