Bewary: scam, phishing and fraud detection

Bewary

Bewary 是一款面向应用和 AI Agent 的诈骗检测 API 和 MCP 服务：为开发者、信任与安全团队以及 Agent 构建者提供钓鱼、欺诈和威胁情报查询。它可查询链接、域名、IP 地址、电话号码、短信短代码、电子邮件地址、加密货币钱包、IBAN、移动应用或支付账号，并返回判定结果（scam、suspicious、safe 或 unknown）、该对象属于诈骗的概率、相关事实，以及代码可据此分支处理的原因代码。未知不代表安全。

此仓库包含客户端：bewary CLI，以及 MCP 客户端（Claude Code、Cursor、Gemini CLI）的配置文件。API 及其数据由 bewary.app 托管。

• 文档：https://bewary.app/docs
• MCP 服务：https://api.bewary.app/mcp（可流式传输的 HTTP，15 个工具）
• OpenAPI：https://api.bewary.app/v1/openapi.json
• 官方 MCP Registry：app.bewary/bewary

免费密钥每月可获得 1,000 点额度，无需信用卡：https://bewary.app/account。每次查询消耗 1 点额度。预付额度包最低 $20，且永不过期。

MCP：为 Agent 提供诈骗检查

支持登录的客户端（Claude、ChatGPT、Claude Code、Cursor）可以连接到 https://api.bewary.app/mcp，并通过 OAuth 登录 Bewary。任何客户端也可以改为在 Authorization: Bearer 标头中发送 API 密钥。

MCP 服务仅在该地址运行：无需安装本地服务或 stdio 服务。下文的 bewary CLI 是终端工具，并非 MCP 服务。

Claude Code

claude mcp add --transport http bewary https://api.bewary.app/mcp \
  --header "Authorization: Bearer $BEWARY_API_KEY"

也可以将此仓库安装为插件，它会添加 MCP 服务和一个技能，告诉 Agent 何时进行检查：

/plugin marketplace add bewary-app/bewary
/plugin install bewary@bewary

**Claude 和 ChatGPT 应用：**添加 URL 为 https://api.bewary.app/mcp 的自定义连接器，并按提示登录。

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "bewary": {
      "url": "https://api.bewary.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_BEWARY_API_KEY" }
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "bewary": {
      "type": "http",
      "url": "https://api.bewary.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_BEWARY_API_KEY" }
    }
  }
}

Windsurf（mcp_config.json）：

{
  "mcpServers": {
    "bewary": {
      "serverUrl": "https://api.bewary.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_BEWARY_API_KEY" }
    }
  }
}

**Gemini CLI：**运行 gemini extensions install https://github.com/bewary-app/bewary，按提示输入密钥；密钥会存储在密钥链中。

工具

工具	可查询的内容
lookup_url	此链接是否可以安全打开，还是钓鱼或恶意软件链接？解析短链接和重定向，并检查其实际跳转目标。
lookup_domain	域名年龄、仿冒品牌的手法、滥用的 TLD、黑名单状态和判定结果。
related_domains	与此域名共享 IP 地址、名称服务器、证书、注册商或页面模板的其他域名。
lookup_ip	网络所有者、ASN、国家/地区、托管类型、反向 DNS。
lookup_phone	电话号码所属国家/地区、号码类型、FTC 和 FCC 投诉记录及判定结果。
lookup_shortcode	谁在运营美国短信短代码，以及该代码是正规、共享还是诈骗代码。
lookup_email	邮件服务器、一次性或免费服务提供商、角色邮箱，以及发件人域名的相关事实。
lookup_wallet	加密货币钱包的诈骗举报、OFAC 制裁记录，以及 Tether 和 Circle 的冻结记录。
lookup_iban	IBAN 是否有效、银行名称和 BIC，以及该 IBAN 是否与收款人所声称的国家/地区不符。
lookup_app	应用是否仍在 App Store 或 Google Play 上架，或已被下架。
lookup_payment_handle	Cash App、PayPal.me 或 Venmo 账号是否存在、是否活跃，以及是否被列入诈骗名单。
watch、unwatch、list_watches、list_events	关注域名、电话号码、钱包或品牌，并查看其变更事件。

查询为只读操作。watch 和 unwatch 只会更改你账户中的关注项。

CLI：在终端进行诈骗检查

无需安装，需使用 Node 18 或更高版本：

export BEWARY_API_KEY="bw_..."
npx bewary url https://amazon-orders-help.top/confirm

Scam  ▂▄▆█  p_scam 0.9116

High    Fake domain (brand + suspicious TLD)  DOMAIN_BRAND_ON_ABUSED_TLD
Medium  Lookalike domain                      DOMAIN_LOOKALIKE_BRAND_WORD

url     https://amazon-orders-help.top/confirm  Scam
domain  amazon-orders-help.top                  Scam

命令：url、domain、phone、shortcode、email、ip、wallet、iban、app、payment-handle、related、watch、watches、unwatch、events。--json 会原样输出 API 的响应；当判定结果达到指定级别时，--fail-on suspicious|scam 会以状态码 2 退出，从而使 CI 步骤失败。源码：cli/。完整指南：https://bewary.app/docs/cli

REST API

curl -s "https://api.bewary.app/v1/url?u=https://amazon-orders-help.top/confirm" \
  -H "Authorization: Bearer $BEWARY_API_KEY"

每次查询都会返回相同的封装结构：verdict、p_scam、reason_codes、包含类型化事实的 entities，以及带有来源类别的 signals。判定基于证据，而非大模型：网络钓鱼和恶意软件信息源、FTC Do Not Call 和 FCC 投诉、CERT Polska、OFAC 制裁名单、证书透明度日志，以及 Bewary 自有的 DNS 历史记录。端点、价格和响应格式：https://bewary.app/docs

此仓库包含什么

路径	内容
cli/	bewary npm 包的源代码
.claude-plugin/、.mcp.json、skills/	Claude Code 插件和市场
.cursor-plugin/、mcp.json	Cursor 插件
gemini-extension.json、GEMINI.md	Gemini CLI 扩展
server.json	该服务在官方 MCP Registry 中的条目

许可证

此仓库中的所有内容均采用 MIT 许可证。Bewary API 的使用受条款和隐私政策约束。问题请联系：[email protected]