Quorel - Web Data MCP

Quorel

为你的 AI Agent 提供任意网站的实时、版本化视图。

注意：此代码库最初构建时名为 Vexaro，之后产品更名为 Quorel。此仓库中的代码、提交历史和软件包名称仍沿用原名，计划进行一次重命名。此仓库是公开的，你现在看到的就是当前实际运行的实现：github.com/var-raphael/vexaro。在线产品、文档和公共 API 已全部更名为 Quorel：quorel.vercel.app

用通俗的英语描述你需要的字段。Quorel 会每晚提取这些字段，永久保存每个历史版本以供查询，并为你的 AI Agent 提供一个 MCP 工具，让它能直接读取、查询甚至修正数据，而你无需编写爬虫。

公开测试版现已上线：quorel.vercel.app 文档：quorel.vercel.app/docs/quickstart

---

功能介绍

大多数数据工具只会提供今天的数据快照，然后就不再管了。Quorel 会永久保存每个历史版本以供查询，让你查看发生了哪些变化以及何时发生，而不只是了解当前情况。

• 用通俗英语定义架构。 描述你需要的字段（title (string), the title of the article），Quorel 就会确定如何提取数据。
• 每晚刷新，保留版本。 每次刷新都会保存为可比较差异的版本。并排比较任意两个版本、一键回滚，或冻结某个版本以防其再次更改。
• 派生任意公共数据集。 像派生代码仓库一样，从他人的数据集开始。
• 所有套餐都支持 MCP，包括免费套餐。 Claude 或任何兼容 MCP 的 Agent 都可以查询数据集、询问自上周以来的变化，甚至自行修复错误行，并将修正发布为可撤销的新版本。
• 无需维护爬虫。 页面底层布局发生变化时，提取流程会自动适配，而不是悄然失效。

零配置试用

公共数据集无需账户或 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=..."
  }
]

在市场中浏览所有公共数据集，替换 slug，即可用相同方式查询任意数据集。

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	跳过前 N 个实体
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	如果存在，则返回数据集的 alt 版本
include_source	true	包含 _source 字段（每个实体的来源 URL）
pretty	true	美化 JSON 输出

速率限制

访问方式	限制
公开（无需身份验证）	每个 IP 每分钟 100 次请求
私有（Bearer 令牌）	每个 IP 每分钟 300 次请求

每个响应都会包含速率限制标头：X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset。

创建自己的数据集

免费账户，无需信用卡。可创建 1 个数据集，最多包含 20 个 URL。

1. 注册：quorel.vercel.app/auth
2. 粘贴 URL 或描述你的意图。 直接导入 URL，或者用通俗的英语描述你的需求，Quorel 会通过网络搜索发现数据源。
3. 定义你的架构。 告诉 Quorel 你需要哪些字段以及它们的含义，例如：score (number), the upvote count。
4. 等待处理。 Quorel 会抓取你的 URL，根据你的架构运行 AI 提取，并为结果创建版本。
5. 调用你的端点。 使用仪表板中的数据集 ID 和 slug，像上面的公开示例一样查询。

访问私有数据集

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

在数据集的仪表板页面中查找你的私有密钥。

MCP：让 Agent 直接处理数据

每个套餐中的每个数据集都附带 MCP 服务，包括免费套餐。Claude 或任何兼容 MCP 的 Agent 都可以筛选、排序、询问有哪些变化，甚至自行修复错误行。

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

Agent 所做的更改会进入与手动操作相同的版本化、可还原系统，不会有任何内容被悄悄覆盖。详情请见：quorel.vercel.app/docs/mcp

版本管理与回滚

• 准确查看更改内容。 并排比较任意两个版本：新增的行、移除的行和更改的值。
• 一键回滚。 刷新时引入了脏数据？立即还原，或冻结某个版本，防止其再次更改。
• 派生任意公开数据集。 像派生代码仓库一样，以他人的数据集为基础，添加自己的字段并发布自己的副本。

详情请见：quorel.vercel.app/docs/versioning

定价

	免费	Pro（$19/月）	Scale
数据集	1	5	无限
每个数据集的 URL 数量	20	100	500
刷新	每晚	通过 ping URL 按需刷新	自定义计划
版本历史与回滚	✅	✅	✅
MCP 访问	✅	✅	✅
支持	社区	电子邮件	专属支持

Scale 即将推出，加入候补名单。

大家用它来构建什么

• 竞争对手的价格历史：跟踪每一次价格变动，而不仅是今天的价格
• 就业市场监控：职位发布、薪资以及已下架的职位
• 房地产动态变化：状态变更、降价、在售天数，均有版本记录
• AI Agent 的实时上下文：让 Claude 检查网站与上周相比发生了哪些变化
• 应用的数据后端：传入查询参数，返回结构化 API，无需自行维护抓取基础设施

文档

• 快速入门
• 创建数据集
• API 参考
• MCP
• Webhooks
• 版本管理与回滚
• 常见问题

关于此仓库

这是 Quorel 的开发代码库，由个人独立构建和维护。它最初以 Vexaro 之名开发；产品后来更名为 Quorel，此次更名已反映在在线产品、文档和对外品牌中。计划对整个代码库进行全面更名，包括软件包名称和内部引用。

代码在此开源：github.com/var-raphael/vexaro。欢迎提交问题、提问和贡献。

在线产品： quorel.vercel.app 联系方式： [email protected]