Skip to main content
Glama
Batman0506

scandomain-mcp

by Batman0506
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

SCANDOMAIN MCP

中文说明

SCANDOMAIN MCP 让 OpenClaw、Hermes、Cursor 等支持 MCP 的 AI Agent 能够调用 SCANDOMAIN 进行域名、IP、端口、服务、标题、ICP、Server Header 和组件等资产 检索。项目同时提供 MCP 服务和可复制的 Agent Skill： skills/scandomain/SKILL.md。

获取 API Key

请访问 SCANDOMAIN 官网，注册并登录后进入 个人中心获取 API Key。每位用户应使用自己的 Key；不要将 Key 提交到 GitHub、 粘贴到公开对话或共享日志中。

从零开始

本项目无需发布到 npm。它会通过 GitHub 下载并运行，因此请先安装 Node.js 20+ 和 Git。

Windows PowerShell：

winget install OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements
winget install Git.Git --accept-package-agreements --accept-source-agreements
node --version
git --version

macOS：

brew install node git
node --version
git --version

Ubuntu/Debian：

sudo apt update
sudo apt install -y nodejs npm git
node --version
git --version

获取 Key 后，可用以下命令单独启动 MCP 服务进行排查。服务启动后会等待 MCP 客户端连接，这是正常行为；用 Ctrl+C 停止。

Windows PowerShell：

$env:SCANDOMAIN_API_TOKEN = "在 https://scandomain.cyayaa.com/ 个人中心获取的 Key"
npx --yes github:Batman0506/scandomain-mcp

macOS/Linux：

SCANDOMAIN_API_TOKEN="在 https://scandomain.cyayaa.com/ 个人中心获取的 Key" \
  npx --yes github:Batman0506/scandomain-mcp

OpenClaw 安装

在终端执行以下命令。将 YOUR_SCANDOMAIN_API_KEY 替换为你从官网获取的 Key：

openclaw mcp add scandomain \
  --command npx \
  --arg -y \
  --arg github:Batman0506/scandomain-mcp \
  --env SCANDOMAIN_API_TOKEN=YOUR_SCANDOMAIN_API_KEY

openclaw mcp doctor scandomain --probe
openclaw mcp tools scandomain

出现 scandomain_search 即表示连接成功。之后可直接向 OpenClaw 发送：

使用 SCANDOMAIN 查询 domain:"baidu.com"，汇总资产数量、IP、端口和服务。

Hermes 安装

将下面内容合并到 ~/.hermes/config.yaml。不要把实际 Key 提交到任何仓库：

mcp_servers:
  scandomain:
    command: npx
    args: ["-y", "github:Batman0506/scandomain-mcp"]
    env:
      SCANDOMAIN_API_TOKEN: "YOUR_SCANDOMAIN_API_KEY"

然后运行：

hermes chat

在 Hermes 对话中输入 /reload-mcp，或重新启动 Hermes。可用下面的提示词确认：

告诉我当前可用的 MCP 工具；然后使用 SCANDOMAIN 查询 ip:"8.8.8.8"。

通用 MCP 配置

需要 Node.js 20 或更高版本。在 OpenClaw、Hermes 或其他支持本地 stdio MCP 的 客户端中添加以下配置：

{
  "mcpServers": {
    "scandomain": {
      "command": "npx",
      "args": ["-y", "github:Batman0506/scandomain-mcp"],
      "env": {
        "SCANDOMAIN_API_TOKEN": "从 https://scandomain.cyayaa.com/ 获取的 API Key",
        "SCANDOMAIN_API_BASE_URL": "https://api.scandomain.cyayaa.com"
      }
    }
  }
}

如果客户端支持 Skill，将 skills/scandomain/SKILL.md 复制到该客户端的 Skill 目录。配置完成后，Agent 可以调用 scandomain_search，例如查询 domain:"baidu.com" 或 port:443 AND country:CN。

工具参数

scandomain_search 使用 Quake 风格 DSL 查询资产：

参数

必填

说明

query

是

查询语句；裸域名和 IPv4 会自动转换为 DSL。

start

否

页码起始值，默认 1。

start_time

否

UTC 开始时间。

end_time

否

UTC 结束时间。

请仅将 SCANDOMAIN 用于已授权的资产梳理、防御性安全分析与风险修复工作。

Related MCP server: FOFA Quake Hunter MCP Server

English

Use SCANDOMAIN from MCP-compatible AI agents with an API key created in the SCANDOMAIN account center. The package provides a local stdio MCP server and a portable agent skill at skills/scandomain/SKILL.md.

The server calls the public SCANDOMAIN API:

POST https://api.scandomain.cyayaa.com/api/getDomain
Content-Type: application/json
api-token: <SCANDOMAIN_API_TOKEN>

Install

The package requires Node.js 20 or newer. Add this MCP configuration to a client such as OpenClaw, Hermes, Cursor, or another stdio MCP client:

{
  "mcpServers": {
    "scandomain": {
      "command": "npx",
      "args": ["-y", "github:Batman0506/scandomain-mcp"],
      "env": {
        "SCANDOMAIN_API_TOKEN": "your-api-key",
        "SCANDOMAIN_API_BASE_URL": "https://api.scandomain.cyayaa.com"
      }
    }
  }
}

Copy skills/scandomain/SKILL.md into the agent's skill directory when the client supports skills. It tells the agent when to call scandomain_search and how to present authorized asset-search results.

Tool

scandomain_search queries assets using Quake-style DSL.

{
  "query": "domain:\"baidu.com\"",
  "start": 1,
  "start_time": "2026-01-01T00:00:00Z",
  "end_time": "2026-01-31T23:59:59Z"
}

Bare domains and IPs are normalized automatically:

baidu.com                 -> domain:"baidu.com"
8.8.8.8                   -> ip:"8.8.8.8"
port:443 AND country:CN    -> unchanged

start defaults to 1. The public SCANDOMAIN endpoint controls page size.

Environment variables

Name

Required

Default

SCANDOMAIN_API_TOKEN

Yes

SCANDOMAIN_API_BASE_URL

No

https://api.scandomain.cyayaa.com

SCANDOMAIN_TIMEOUT_MS

No

20000

SCANDOMAIN_API_KEY is accepted as a compatibility alias for the token.

Development

npm install
npm run check
npm test

Run the server locally:

SCANDOMAIN_API_TOKEN="your-api-key" npm start

Security

Keep API keys out of prompts, repositories, and shared logs. Use SCANDOMAIN only for authorized asset discovery and defensive security work.

License

MIT

Install Server
A
license - permissive license
B
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Batman0506/scandomain-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server