Arugula

Arugula

无论人们在哪里提出需求，都能找到合适的优惠。

Arugula 是一款匹配引擎。用户会在自己的助手、网站或聊天中用自己的话说出需求。Arugula 会根据含义，将请求与商家的优惠进行匹配，并按匹配度从高到低返回结果。每条优惠都附有价格、一句话说明匹配原因，以及商家的购买链接。

• 仅按匹配度排序。 没人能付费提高排名。
• 佣金公开披露。 如果你通过这些链接购买，Arugula 可能会获得佣金，但你无需额外付费。每份优惠列表都会说明这一点。
• 无需账户。 下方的所有入口都无需注册即可使用。
• 没有合适的结果时，就不显示任何内容。

网站：arugulanet.com · 隐私：arugulanet.com/privacy · 条款：arugulanet.com/terms

使用 Arugula 即表示你同意 arugulanet.com/terms。隐私： arugulanet.com/privacy。

使用方式

入口	适用对象	状态
MCP 服务	Claude、Cursor、Open WebUI、LibreChat、Jan、LM Studio 以及任何 MCP 客户端	已上线
Telegram	聊天和群组	已上线
站内搜索	任何带有搜索框的网站	已上线
Shopify	Shopify 商店	已上线
Google Tag Manager	使用 GTM 的网站	已上线（导入）；目录收录审核中
WordPress	WordPress 网站	已上线（ZIP）；WordPress.org 收录审核中
Cloudflare Zaraz	使用 Zaraz 的网站	已上线
Cloudflare Worker	使用 Cloudflare 但未使用 Zaraz 的网站	已上线
聊天机器人	Chatwoot、Botpress、Rasa、Voiceflow 以及你自己的机器人	已上线，可按需申请合作伙伴密钥
Python	你自己的 Agent（LangChain、LangGraph、CrewAI）	已在 PyPI 上线
JavaScript	你自己的 Agent	即将推出
Chrome 和 Firefox 扩展	你的浏览器	即将推出
Claude 目录、ChatGPT 应用	助手	即将推出
Discord	服务器	即将推出

MCP 服务

https://mcp.arugulanet.com/mcp：Streamable HTTP。无需密钥或登录。

工具	功能
find_offers	接收自然语言请求，并按匹配度从高到低返回合适的优惠。
get_offers	获取 find_offers 为请求找到的优惠；匹配可能需要几秒钟。
explain_match	说明某项优惠为何符合请求。

下面每个客户端都有自己的地址，以 ?ch= 结尾。此标签仅用于标记发送请求的客户端类型，方便我们了解人们使用哪些客户端。

Claude（网页版和桌面版）：打开 Settings，然后依次选择 Connectors 和 Add custom connector，输入 https://mcp.arugulanet.com/mcp?ch=claude-connector。自定义连接器仅适用于部分 Claude 套餐。

Claude Code：

claude mcp add --transport http arugula "https://mcp.arugulanet.com/mcp?ch=claude-connector"

Cursor： 将以下内容添加到 ~/.cursor/mcp.json（适用于所有项目）或 .cursor/mcp.json（适用于单个项目）。此仓库 也是一个 Cursor 插件（.cursor-plugin/plugin.json 和 mcp.json）。

{
  "mcpServers": {
    "arugula": {
      "url": "https://mcp.arugulanet.com/mcp?ch=cursor"
    }
  }
}

如果你的系统会打开 cursor:// 链接，也可以一键安装：

cursor://anysphere.cursor-deeplink/mcp/install?name=arugula&config=eyJ1cmwiOiJodHRwczovL21jcC5hcnVndWxhbmV0LmNvbS9tY3A/Y2g9Y3Vyc29yIn0=

Open WebUI（0.6.31 或更高版本）：打开 Admin Settings，然后依次选择 External Tools 和 + Add Server。类型选择 MCP (Streamable HTTP)，URL 填写 https://mcp.arugulanet.com/mcp?ch=open-webui，Auth 选择 None。Open WebUI 服务必须能够访问此 URL。

LibreChat： 在 librechat.yaml 中添加：

mcpServers:
  arugula:
    type: streamable-http
    url: https://mcp.arugulanet.com/mcp?ch=librechat
    title: Arugula
    description: Find offers that fit what you want, ranked by fit only.
    timeout: 60000

Jan： 打开 Settings，然后选择 MCP Servers，再点击 + Add MCP Server。名称填写 arugula，传输方式选择 HTTP，URL 填写 https://mcp.arugulanet.com/mcp?ch=jan。为你使用的模型启用工具。

LM Studio（0.3.17 或更高版本）：打开 Program 选项卡，然后依次选择 Install 和 Edit mcp.json，并在 mcpServers 中添加以下内容：

"arugula": {
  "url": "https://mcp.arugulanet.com/mcp?ch=lm-studio"
}

其他 MCP 客户端： 使用 https://mcp.arugulanet.com/mcp，传输方式选择 Streamable HTTP，无需身份验证。

官方 MCP 注册表中的条目为 server.json（com.arugulanet/arugula）。

Telegram

打开 @ArugulaNetBot，告诉它你想要什么。若要与他人一起使用，请将它添加到群组。 若要在任何聊天中使用，请输入 @ArugulaNetBot，后接你的请求。

站点搜索

在任何带有搜索框的页面中添加一行代码。访客搜索时，符合条件的优惠会显示在搜索表单下方。 此脚本不会设置 Cookie。

<script async src="https://api.arugulanet.com/embed/v0.5.2/search.js"
        integrity="sha384-VUDq6tLbkK5ID6JJ8KnwaPN9dWB5VCKUxZ/r7gJTZdpXxn+yqTE2S7AKsVNmuXGD"
        crossorigin="anonymous" data-channel="site-search"></script>

脚本会自动查找搜索框：input[type=search]、搜索表单，或名称为 q、s、search 或 query 的输入框。以下属性均为可选：

属性	设置内容	默认值
data-selector	搜索输入框，例如 #q	自动查找
data-container	优惠的显示位置	紧跟在搜索表单后
data-limit	显示的优惠数量	3

每个版本的哈希值位于 https://api.arugulanet.com/embed/v0.5.2/integrity.json。每个版本的路径 都不会改变。

Shopify

在主题中打开 Edit code，然后打开 layout/theme.liquid，并在 </body> 前粘贴以下内容：

<script async src="https://api.arugulanet.com/embed/v0.5.2/search.js"
        integrity="sha384-VUDq6tLbkK5ID6JJ8KnwaPN9dWB5VCKUxZ/r7gJTZdpXxn+yqTE2S7AKsVNmuXGD"
        crossorigin="anonymous" data-channel="shopify"></script>

它会像站点搜索一样关联到你店铺的搜索功能。

Google Tag Manager

标签模板是此仓库中的 template.tpl。它会加载站点搜索脚本。

1. 在 GTM 中打开 Templates，然后在 Tag Templates 下方点击 New。
2. 打开右上角的菜单，选择 Import，并选择 template.tpl。保存。
3. 添加一个类型为 Arugula 的新标签，并将触发条件设为 All Pages。发布容器。

你也可以从 https://api.arugulanet.com/arugula-gtm-template.zip 下载 ZIP 格式的模板。

WordPress

下载 arugula-wordpress.zip。在 WordPress 中打开 Plugins， 然后依次选择 Add New 和 Upload Plugin。选择文件并启用插件。它会自动关联到你网站的搜索功能，无需任何设置。插件的 readme.txt 列出了它发送和存储的所有内容。

Cloudflare Zaraz 和 Workers

有三种接入方式，均位于 cloudflare/：

1. Zaraz Custom HTML： 添加一个 Custom HTML 工具，使用站内搜索代码片段，设置 data-channel="zaraz"，并为其指定一个 Pageview 操作。
2. Zaraz Custom Managed Component： 使用 npx managed-component-to-cloudflare-worker ./index.js arugula 将 cloudflare/component 部署为 Worker，然后在 Third-party tools 下添加它。
3. Cloudflare Worker，适用于使用 Cloudflare 但未使用 Zaraz 的网站：cloudflare/worker 会在边缘添加脚本（npx wrangler deploy）。

即使 Zaraz 在每次单页导航时都会触发，脚本也只会在每个页面运行一次。

聊天机器人

你已有的机器人可以将用户消息转发给 Arugula，并展示返回的优惠：

POST https://api.arugulanet.com/v1/partner/intents
Authorization: Bearer <partner key>

{"text": "a linen sofa under S$1,500", "user_id": "<your user's id>"}

响应包含 offers，其中每项都有一个 tracked_url，以及一条现成的 text 回复。对于 Chatwoot，请将 Agent 机器人的 webhook 设置为 https://api.arugulanet.com/hooks/chatwoot/<partner id>?key=<partner key>。要获取合作伙伴密钥， 提交 issue。

Python

PyPI 上的 arugulanet。需要 Python 3.9 或更高版本，无依赖项，也无需账户。

pip install arugulanet

from arugulanet import Arugula

offers = Arugula().find_offers("a hotel room in Singapore for two nights", party_size=2)

对于 LangChain 和 LangGraph，请安装 "arugulanet[langchain]" 或 "arugulanet[langgraph]"，并使用 from arugulanet.langchain import find_offers_tool。对于 CrewAI，请安装 "arugulanet[crewai]"，并使用 from arugulanet.crewai import FindOffersTool。

JavaScript

即将以 arugulanet 的名称发布到 npm。需要 Node 18 或更高版本，无运行时依赖项。包含适用于 OpenAI 函数调用、LangChain.js 和 CrewAI 风格 Agent 的工具。

import { Arugula } from "arugulanet";

const offers = await new Arugula().findOffers("a hotel room in Singapore for two nights", { party_size: 2 });

展示优惠

如果你基于 Arugula 构建，请在展示优惠时附上这行文字：

仅根据匹配度排序。如果你通过这些链接购买，Arugula 可能会获得佣金，你无需额外付费。

工具和 API 会在每份优惠列表中以 disclosure 的形式返回这段文字。

品牌

徽标、图标、头像、网站图标和社交图片位于 brand/，使用规则见 brand/BRAND.md。请按原样使用：不要重新着色、添加轮廓或特效。

帮助

如有疑问、问题或需求：提交 issue。

许可证

本仓库采用 Apache License 2.0。各软件包使用各自的许可证：Python 和 JavaScript 软件包采用 MIT 许可证，WordPress 插件采用 GPLv2 或更高版本许可证。