Quorel - Web Data MCP

Quorel

AI エージェントに、あらゆるウェブサイトの最新かつバージョン管理されたビューを提供します。

注：このコードベースは、製品名が Quorel に変更される前は、Vexaro として開発され、その名前が付けられていました。このリポジトリ内のコード、コミット履歴、パッケージ名には、引き続き以前の名前が反映されています。名称変更の対応を予定しています。このリポジトリは公開されており、ここでご覧いただいているのは、実際に現在使われている実装です：github.com/var-raphael/vexaro。公開中の製品、ドキュメント、パブリック API はすでにすべて Quorel にブランド変更されています：quorel.vercel.app

取得したいフィールドを、平易な英語で説明してください。Quorel が毎晩データを抽出し、過去のすべてのバージョンをいつでもクエリできる状態で保存します。さらに、スクレイパーを自分で書かなくても、データの読み取りやクエリ、直接の修正までできる MCP ツールを AI エージェントに提供します。

公開ベータ版を利用できます：quorel.vercel.app ドキュメント：quorel.vercel.app/docs/quickstart

---

できること

ほとんどのデータツールは今日のスナップショットを渡して、それで終わりです。Quorel は過去のすべてのバージョンをいつでもクエリできる状態で保存するため、今の状態だけでなく、何がいつ変わったのかも確認できます。

• 平易な英語でスキーマを定義。 取得したいフィールド（title (string), the title of the article）を説明するだけで、Quorel が抽出方法を判断します。
• 毎晩更新し、バージョン管理。 更新のたびに、差分を確認できるバージョンとして保存します。任意の2つのバージョンを並べて比較したり、ワンクリックでロールバックしたり、バージョンを固定して以後変更されないようにしたりできます。
• 公開データセットをフォーク。 リポジトリをフォークするように、ほかのユーザーのデータセットを元に始められます。
• Free を含むすべてのプランで MCP を利用可能。 Claude や、MCP 対応のエージェントはデータセットをクエリし、先週からの変更点を尋ねたり、不正な行を自ら修正したりできます。修正内容は、新しいバージョンとして公開され、元に戻すこともできます。
• スクレイパーのメンテナンスは不要。 元のページのレイアウトが変わっても、抽出処理が適応するため、気付かないうちに壊れることはありません。

セットアップなしですぐに試す

公開データセットには、アカウントも API キーも必要ありません。GET リクエストを送るだけです。

GET https://quorel.vercel.app/api/1/hacker-news-top/active/
    ?format=json
    &limit=5
    &sort=score:desc

[
  {
    "title": "Show HN: I built a source of truth for the web",
    "score": 412,
    "comments": 187,
    "url": "https://news.ycombinator.com/item?id=..."
  }
]

マーケットプレイスですべての公開データセットを確認し、スラッグを入れ替えるだけで、どのデータセットも同じ方法でクエリできます。

API URL の構成

https://quorel.vercel.app/api/{dataset_id}/{name-slug}/{version}/

部分	意味
dataset_id	データセットの数値 ID
name-slug	データセット名を小文字にして、ハイフンでつないだもの
version	active（固定バージョン）、latest、または v1、v2、v3 など

クエリパラメーター

すべてのエンドポイントで同じパラメーターを使用できます。必要なものをいくつでも組み合わせてください。

パラメーター	デフォルト	説明
format	json	出力形式：json、jsonl、csv、tsv、xml、parquet
limit	all	返すエンティティの最大数
offset	0	先頭からスキップするエンティティ数
sort	none	フィールドで並べ替えます。例：sort=score:desc
keywords	none	すべてのフィールドを対象とした全文検索。OR 検索にするにはカンマで区切ります
keywords_mode	or	キーワードを AND 検索するには and を指定します
filter	none	フィールドの完全一致検索。例：filter=category:finance。複数指定できます
filter_contains	none	フィールドの部分一致検索。複数指定できます
keep_field	none	これらのフィールドのみを返します（ドット記法に対応）
drop_field	none	レスポンスからこれらのフィールドを除外します
dedup	false	重複するエンティティを削除します。特定のフィールドを使って重複を除くには dedup_key=field1,field2 を指定します
denull	false	null と空文字列の値を再帰的に削除します
flatten	false	ネストされたオブジェクトをドット記法のキーにフラット化します（csv、tsv、parquet では自動的に適用されます）
sample	none	ランダムに抽出した N 件のエンティティを返します
count	false	一致したエンティティの件数のみを返します
alt	false	データセットに代替バージョンが存在する場合、それを返します
include_source	true	各エンティティの出典 URL である _source フィールドを含めます
pretty	true	JSON を整形して出力します

レート制限

アクセス	制限
パブリック（認証なし）	1 分あたり 100 リクエスト、IP ごと
プライベート（Bearer トークン）	1 分あたり 300 リクエスト、IP ごと

レート制限のヘッダーは、すべてのレスポンスに含まれます：X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset。

独自のデータセットを作成する

無料アカウントで利用でき、クレジットカードは不要です。データセットは 1 つ、URL は最大 20 件です。

1. quorel.vercel.app/auth で登録します
2. URL を貼り付けるか、目的を説明します。 URL を直接インポートするか、平易な英語で実現したいことを説明すると、Quorel がウェブ検索でソースを見つけます。
3. スキーマを定義します。 必要なフィールドとその意味を Quorel に伝えます。例：score (number), the upvote count。
4. 処理が終わるまで待ちます。 Quorel が URL をクロールし、スキーマに基づいて AI 抽出を実行し、結果をバージョン管理します。
5. エンドポイントにアクセスします。 上記のパブリックの例と同じ方法で、ダッシュボードに表示されるデータセット ID とスラッグを使ってクエリします。

プライベートデータセットへのアクセス

GET https://quorel.vercel.app/api/42/my-dataset/active/
Authorization: Bearer your_private_key

データセットのダッシュボードページでプライベートキーを確認できます。

MCP：エージェントがデータを直接操作できるようにする

すべてのデータセットには、Free を含むすべてのプランで MCP サーバーが付属します。Claude や MCP 対応のエージェントは、データの絞り込みや並べ替え、変更点の確認、さらには不正な行の修正まで行えます。

Inside a Claude chat:

> what changed on job-board-listings this week
→ queried v14 vs v9, 23 postings added, 8 removed

> fix the missing salary fields and publish v15
→ reviewed 200 rows, filled 14 fields from listing text
→ live at /job-board-listings/v15

エージェントによる変更は、手動で行った変更と同じバージョン管理可能で元に戻せるシステムに反映され、何も通知なく上書きされることはありません。詳しくは、quorel.vercel.app/docs/mcp をご覧ください。

バージョン管理とロールバック

• 変更点を正確に確認できます。 任意の 2 つのバージョンを並べて比較し、追加された行、削除された行、変更された値を確認できます。
• ワンクリックでロールバックできます。 更新で不正なデータが取り込まれてしまった場合は、すぐに元に戻すか、バージョンを固定して変更できないようにできます。
• 任意のパブリックデータセットをフォークできます。 リポジトリをフォークするように他のユーザーのデータセットを元にして、独自のフィールドを追加し、自分のコピーを公開できます。

詳しくは、quorel.vercel.app/docs/versioning をご覧ください。

料金

	Free	Pro ($19/mo)	Scale
データセット	1	5	無制限
データセットあたりの URL 数	20	100	500
更新	毎晩	ping URL 経由でオンデマンド	カスタムスケジュール
バージョン履歴とロールバック	✅	✅	✅
MCP アクセス	✅	✅	✅
サポート	コミュニティ	メール	専任サポート

Scale は近日公開予定です。ウェイトリストに登録。

利用例

• 競合他社の価格履歴：今日の価格だけでなく、価格変更をすべて追跡
• 求人市場のモニタリング：求人情報、給与、掲載終了した求人を把握
• 不動産の経時的な変化：ステータスの変更、値下げ、販売日数をバージョン管理
• AI エージェント向けの最新コンテキスト：Claude が先週からサイトで何が変わったかを確認
• アプリ向けのデータバックエンド：クエリパラメーターを渡すだけで、構造化された API レスポンスを取得。スクレイピング基盤を管理する必要はありません

ドキュメント

• クイックスタート
• データセットの作成
• API リファレンス
• MCP
• Webhook
• バージョン管理とロールバック
• よくある質問

このリポジトリについて

これは Quorel の開発・保守を一人で行っている作業用コードベースです。もともとは Vexaro という名称で開発されていましたが、その後、製品名を Quorel に変更しました。この変更は、公開中の製品、ドキュメント、対外的なブランドに反映されています。このコードベース全体の名称変更（パッケージ名、内部参照など）は今後予定されています。

コードはここで公開されています：github.com/var-raphael/vexaro。課題の報告、質問、コントリビューションを歓迎します。

公開中の製品： quorel.vercel.app 連絡先： [email protected]