tscanplus

TscanPlus 扫描助手

通过 MCP 工具（首选）或 CLI 驱动 TscanPlus（与无影 GUI 版共享 config.yaml、config.db）。参数语义对齐 TscanClient 命令行版（-m 八大模块、-h/-u/-d/-ck 等）。

本文档为 Agent Skill，可放入宿主技能目录，或复制章节到自定义系统提示。对话示例见 examples.md。

授权（强制）

• 仅对用户明确拥有书面授权的目标扫描（自有 lab、渗透项目 scope 内）。
• 未获授权时：拒绝扫描，并说明原因。
• 默认避免：全端口 1-65535、大范围 C 段、生产环境、开启 poc_check/pwd_check/poc_full，除非用户明确要求。
• 资产过多时不要一次开启全部模块，以免耗时过久或占满 CPU。
• 扫描前用一句话复述：目标、模块、是否含 POC/爆破。

产品能力概览

TscanPlus / CLI 集成八大安全检测模块：

多模块联动使用 tscan_scan，modules 对应 -m，流程与 GUI 项目管理一致：

cyber → domain → port → crack → url → poc → dir → js

前一项的全部结果会作为下一项的输入。常用组合（授权 lab 内）：

MCP 工具选型

通用参数（MCP / CLI）

结果存放：

• MCP 工具返回 JSON（data.results、data.counts）。
• CLI 写日志 TscanPlus-Result.txt 及各模块 txt，并写入 config.db（可与 GUI 共用）。

项目名 MCP 的行为

GUI 注意： 单工具（如 ip_scan）可能不在项目列表显示行，但 ipscan 等表可有 Project='MCP'；tscan_scan 会在 project 表登记。

---

各模块参数（MCP ↔ CLI）

1. 端口扫描 ip_scan（port）

tscan_scan 额外：ports_add→-pa，exclude_hosts→-hn，smart_scan→-nosmart 取反。

2. Web 指纹 url_scan（url）

3. POC poc_scan（poc）

POC 路径在 config.yaml（xray 1.0 格式），与 GUI 一致。

4. 弱口令 pwd_crack（crack）

5. 子域名 subdomain_scan（domain）

6. 目录 dir_scan（dir）

7. JS js_scan（js）

8. 空间测绘 cyber_search（cyber）

与 GUI「空间测绘」页字段下拉一致；field 决定如何把 query 转成各引擎 API 语句。

field 可选值（对齐 GUI）：

用法要点：

• 推荐：选具体 field，query 只填关键词（与 GUI 搜索框相同），不要写 domain="xxx" 这类包装语法。
• custom：各测绘平台语法不同，一般无法跨平台通用；需自行按平台调试。
• 多关键词：逗号分隔，如 example.com,example.net（与 GUI 一致）。
• CLI -ck 常写完整语句时，MCP 应设 field=custom；或 -ck example.com 配合默认 domain。

tscan_scan 中用 cyber_query 传查询内容，cyber_field 传上表字段类型（默认 domain）。

9. 综合扫描 tscan_scan

在单模块参数基础上，常用额外字段：

---

推荐参数（默认保守）

单主机端口（首选入门）：

tool: ip_scan
target: "10.0.0.1"
ports: "80,443,8080,8443,22"
ping_scan: true
ip_finger: false
poc_check: false
pwd_check: false
thread: 200
timeout: 3
include_results: true
result_limit: 100

内网 C 段（lab，控制范围）：

tool: tscan_scan
targets: "192.168.1.0/24"
modules: "port,url"
ports: "Top100"
thread: "300"
ping_scan: true
smart_scan: true
include_results: true
result_limit: 200

仅在用户明确要求时启用： poc_check、pwd_check、poc_full、modules 含 poc/crack、全端口。

---

MCP 接入

stdio（推荐）

{
  "mcpServers": {
    "tscanplus": {
      "command": "/绝对路径/TscanPlus",
      "args": ["mcp", "stdio"]
    }
  }
}

Streamable HTTP（推荐远程传输）

TscanPlus mcp serve -listen 127.0.0.1:8088
# 或显式指定：-transport streamable

{
  "mcpServers": {
    "tscanplus": {
      "url": "http://127.0.0.1:8088/mcp"
    }
  }
}

HTTP+SSE（旧版兼容）

TscanPlus mcp serve -listen 127.0.0.1:8088 -transport sse

{
  "mcpServers": {
    "tscanplus": {
      "url": "http://127.0.0.1:8088/sse"
    }
  }
}

GUI：AI 辅助 → MCP 服务配置 可选择传输模式（Streamable HTTP / HTTP+SSE），启停服务并导出 Skill 模板 zip。

各宿主引用见 README.md。

---

调用后如何汇报

解析 JSON（success、message、data）：

1. 摘要：目标、模块、开放端口/URL 数、高危 poc_vul。
2. 表格化列表：results.ipscan / urlscan / poccheck / pwdcrack / dirscan / jsfinder / subdomain / cyber 关键字段。
3. project_cleared: true：已清空默认 MCP 项目旧数据。
4. counts > result_limit：说明仅返回前 N 条，全量在 config.db 或 GUI。

不要只回复「扫描完成」。

---

常见工作流

1. IP → Web → 漏洞： ip_scan（常见 Web 端口）→ 拼 URL → url_scan → 用户确认 → poc_scan
2. 子域 → 端口 → Web： subdomain_scan → tscan_scan（modules=port,url）→ 按需 POC
3. 测绘 → 扫描： cyber_search → 提取 IP/URL → 用户确认 → ip_scan / url_scan
4. 单项目持续： 全程 project=pentest-xx，阶段结束用 fresh_project=true 重扫

排错

MCP 不可用时的 CLI

# 默认：port + url + poc（-h 触发）
TscanPlus -h 192.168.1.1/24

TscanPlus -m port -h 192.168.1.1 -p 80,443,3306 -t 600
TscanPlus -m url,poc,dir,js -uf urls.txt -finger tiny
TscanPlus -m domain,port,url,poc -d example.com -api
TscanPlus -m crack -h 192.168.1.1 -p 22 -s ssh -user root -pwd 123456
TscanPlus -m cyber,port,poc -ck 'domain="example.com"'
TscanPlus -pr MyProject -m port,url,poc -h 192.168.1.1

TscanPlus mcp stdio
TscanPlus mcp serve -listen 127.0.0.1:8088
TscanPlus mcp serve -listen 127.0.0.1:8088 -transport sse

CLI 不自动清空项目；MCP 未指定 project 时默认 MCP 且每次调用前清空。