Hermes/TscanPlus
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
snapshot-main
TscanPlus/TscanPlus-skill/SKILL.md
T
Hermes 6be840d9fa chore: import TideSec/TscanPlus main docs snapshot 
History-free lightweight snapshot (docs/skill only).
Large binaries and media published via Gitea Releases.
2026-07-24 05:39:35 +00:00

14 KiB
Raw Permalink Blame History

name, description
name description
tscanplus Operates TscanPlus security scanner via MCP tools or CLI for authorized targets only. Use when the user mentions TscanPlus, port/URL/POC/subdomain scanning, MCP integration, ip_scan, tscan_scan, or recon on IPs, domains, or URLs in any AI assistant with MCP support.

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 集成八大安全检测模块：

模块 CLI -m MCP 单工具 说明
端口扫描 port ip_scan IP/CIDR、存活探测、端口、可选服务指纹/POC/弱口令
Web 指纹 url url_scan URL 指纹识别、Title、可选联动 POC
POC 验证 poc poc_scan xray 1.0 格式 POC，可按指纹或全量
弱口令 crack pwd_crack 多协议爆破，targets 为 host:port
目录枚举 dir dir_scan 路径爆破，可自定义字典
JS 敏感信息 js js_scan JS 文件中密钥、接口等
子域名 domain subdomain_scan 字典 + 可选 API（key 在 config.yaml）
空间测绘 cyber cyber_search Hunter/FOFA 等（引擎在 config.yaml）

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

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

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

场景 modules / CLI -m
内网主机摸底 port,url,poc 或 port,poc,crack
Web 专项 url,poc,dir,js
域名资产 domain,port,url,poc
测绘后深挖 cyber,port,url,poc

MCP 工具选型

用户意图 优先工具 说明
单 IP/CIDR 看端口 ip_scan target 必填；先小范围 ports
多目标只扫端口+弱口令+POC ip_scan 或 tscan_scan ip_scan 用 pwd_check/poc_check
一批 URL 指纹/Web url_scan targets 逗号分隔
已知 URL 打 POC poc_scan 慎用 poc_full
弱口令 pwd_crack targets: 192.168.1.1:22,192.168.1.1:3306
目录 / JS dir_scan / js_scan 需完整 URL
子域名 subdomain_scan domains；API 需 config
空间测绘 cyber_search query 对齐 -ck
多阶段、结果传递 tscan_scan 大任务可分阶段执行

通用参数（MCP / CLI）

MCP / 含义 CLI 默认 说明
project -pr 未指定→MCP 写入 config.db 的项目名；见下文「项目 MCP」
fresh_project — false 指定 project 时是否先清空该项目
proxy -proxy 配置全局代理 HTTP/SOCKS5；端口扫描仅 SOCKS5
include_results — true 响应 JSON 是否带 data.results
result_limit — 200 每类结果最多条数，最大 2000
ping_scan 未用 -np 即探测 true 存活探测
smart_scan 未用 -nosmart true 大网段启发式扫描（tscan_scan）
timeout -time 3 通用超时（秒）
web_timeout -wt 10 Web 超时（秒）

结果存放：

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

项目名 MCP 的行为

情况 行为
未传 project 使用 MCP，本次工具调用前自动清空该项目数据
传 project=自定义名 默认追加；清空则 fresh_project=true

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

各模块参数（MCP ↔ CLI）

1. 端口扫描 ip_scan（port）

MCP 参数 CLI 默认 说明
target -h 必填 192.168.1.1、192.168.1.0/24、范围
ports -p Top100 22、1-65535、22,80,443
thread -t 600 并发
timeout -time 3 秒
ping_scan 默认探测 / -np 关闭 true 存活探测
ip_finger 服务指纹 配置项 服务识别
poc_check 联动 POC false 开放端口转 URL 后 POC
pwd_check 联动 crack false 弱口令
proxy -proxy — 建议 SOCKS5

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

2. Web 指纹 url_scan（url）

MCP 参数 CLI 默认 说明
targets -u / -uf 内容 必填 URL，逗号或换行分隔
thread URL 线程 50
web_timeout -wt 10 秒
finger -finger tiny tiny / min / all
cookie -cookie — 认证场景
poc_check 联动 POC false
proxy -proxy —

3. POC poc_scan（poc）

MCP 参数 CLI 默认 说明
targets -u 必填 HTTP(S) URL
thread -num 20 POC 并发
poc_full -full false true 时不匹配指纹，扫全部 POC
poc_name -pocname — 如 weblogic
poc_level -poclevel 1+2+3+4+5 级别过滤
proxy -proxy —

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

4. 弱口令 pwd_crack（crack）

MCP 参数 CLI 默认 说明
targets -h 必填 host:port，逗号分隔
services -s all ssh,mysql,rdp 等
user -user 内置字典 逗号分隔多个
pwd -pwd 内置字典
cmd -c whoami 成功后执行命令
thread -br 1 爆破线程
timeout -time 3

5. 子域名 subdomain_scan（domain）

MCP 参数 CLI 默认 说明
domains -d 必填 逗号分隔主域
sub_api -api false API key 在 config.yaml
sub_dict -dc 内置 绝对路径
ports 联动扫描端口 80,443 发现子域后的端口
proxy -proxy —

6. 目录 dir_scan（dir）

MCP 参数 CLI 默认 说明
urls -u 必填 基 URL
thread -ds 20
dict -dd 内置 10k 绝对路径
timeout -time 3
proxy -proxy —

7. JS js_scan（js）

MCP 参数 CLI 默认 说明
urls -u 必填
timeout -time / Web 3
proxy -proxy —

8. 空间测绘 cyber_search（cyber）

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

MCP 参数 CLI 默认 说明
query -ck 必填 见下表「query 写法」
field 查询类型 domain 见下表
engines — config 已启用 逗号分隔引擎名
project / fresh_project -pr MCP / false 同通用参数
include_results / result_limit — true / 200 同通用参数

field 可选值（对齐 GUI）：

field GUI 名称 query 示例（不加引号）
domain 域名 example.com
ip IP 地址 1.1.1.1、192.168.1.0/24
port 端口 80、3306
product 应用 nginx、apache
title 标题 管理后台
service 服务 mysql、ssh
cert 证书 证书关键词
icp 备案 备案号或主体名
body Body 页面正文关键词
icon Icon Icon URL 或 hash
custom 自定义 各平台完整语法，如 domain="example.com" && port="443"

用法要点：

  • 推荐：选具体 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

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

MCP 参数 CLI 说明
targets -h/-u/-d/-ck 等 按 modules 解析目标
modules -m 默认 port,url,poc
domains -d domain 模块主域
cyber_query -ck 测绘语句
ports / ports_add -p / -pa
exclude_hosts -hn
thread / url_thread / poc_thread / dir_thread -t 等
finger -finger
poc_full / poc_name / poc_level POC 相关
crack_* -s/-user/-pwd/-c/-br 弱口令
sub_api / sub_dict 子域
dir_dict -dd

推荐参数（默认保守）

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

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 重扫

排错

现象 处理
看不到 TscanPlus 工具 检查 MCP 配置、二进制绝对路径、重载 MCP
长时间无响应 同步阻塞扫描；缩小 ports/targets，先关 POC/爆破
卡在 xxx open 升级版本；重启 mcp serve 或 GUI 内 MCP 服务
GUI 无 MCP 项目行 单工具可能不写 project 表；查库表或改用 tscan_scan
测绘/子域无结果 检查 config.yaml 中 API Key、Engines
结果与 GUI 不一致 共用同一 config.yaml / config.db

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 且每次调用前清空。

Reference in New Issue View Git Blame Copy Permalink