Hermes/TscanPlus
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
snapshot-main
TscanPlus/TscanPlus-skill/examples.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

13 KiB
Raw Permalink Blame History

TscanPlus MCP 对话与模块示例

以下示例适用于任何能调用 TscanPlus MCP 工具的 AI 助手。参数语义对齐 TscanClient / TscanPlus CLI（-m 八大模块）。执行前须确认授权。

模块对照： port→ip_scan，url→url_scan，poc→poc_scan，crack→pwd_crack，dir→dir_scan，js→js_scan，domain→subdomain_scan，cyber→cyber_search，多模块联动→tscan_scan。

一、端口扫描 ip_scan（port）

示例 1-1：单 IP 常见 Web 端口

用户： 帮我扫 10.211.55.2 有哪些常见 Web 端口。

Agent：

  1. 确认授权。
  2. 调用 ip_scan：
target: "10.211.55.2"
ports: "80,443,8080,8443,8000,8888,22"
ping_scan: true
ip_finger: false
poc_check: false
pwd_check: false
thread: 200
timeout: 3
include_results: true
  1. 汇报 data.results.ipscan 的 host、port、target、title。

CLI 等价： TscanPlus -m port -h 10.211.55.2 -p 80,443,8080,8443,8000,8888,22 -t 200

示例 1-2：C 段 Top100（lab）

用户： 扫 192.168.1.0/24 的 Top100 端口，不要 POC。

tool: ip_scan
target: "192.168.1.0/24"
ports: "Top100"
thread: 400
ping_scan: true
poc_check: false
pwd_check: false
include_results: true
result_limit: 300

CLI： TscanPlus -m port -h 192.168.1.0/24 -t 400

示例 1-3：指定端口 + 服务指纹

用户： 对 192.168.1.10 扫 22,80,443,3306,3389 并识别服务。

tool: ip_scan
target: "192.168.1.10"
ports: "22,80,443,3306,3389"
ip_finger: true
poc_check: false
thread: 300

示例 1-4：端口扫描联动弱口令（需明确授权）

用户： 已对 192.168.1.5 授权，对 22 和 3306 做弱口令检测。

tool: ip_scan
target: "192.168.1.5"
ports: "22,3306"
pwd_check: true
poc_check: false
thread: 100

CLI： TscanPlus -m port,crack -h 192.168.1.5 -p 22,3306

示例 1-5：端口 + POC（需明确授权）

tool: ip_scan
target: "10.0.0.100"
ports: "80,443,8080"
poc_check: true
pwd_check: false
thread: 200

二、Web 指纹 url_scan（url）

示例 2-1：单 URL 指纹

用户： 识别 http://test.com:8080 的 Web 指纹。

tool: url_scan
targets: "http://test.com:8080"
finger: tiny
web_timeout: 10
poc_check: false
thread: 30
include_results: true

CLI： TscanPlus -m url -u http://test.com:8080 -finger tiny

示例 2-2：批量 URL

用户： 对这些站做 Web 探测：a.com 和 b.com 的 https。

tool: url_scan
targets: "https://a.com,https://www.b.com"
finger: min
thread: 50
include_results: true

CLI： TscanPlus -m url -u https://a.com,https://www.b.com -finger min

示例 2-3：带 Cookie 的认证站

tool: url_scan
targets: "http://internal.com/admin/"
cookie: "session=abc123; token=xyz"
finger: tiny
web_timeout: 15

CLI： TscanPlus -m url -u http://internal.com/admin/ -cookie "session=abc123"

示例 2-4：URL 指纹 + 联动 POC

用户： 已对下列 URL 授权打 POC。

tool: url_scan
targets: "http://10.0.0.1:8080,http://10.0.0.2"
poc_check: true
finger: tiny
thread: 30

CLI： TscanPlus -m url,poc -u http://10.0.0.1:8080,http://10.0.0.2

示例 2-5：代理访问

tool: url_scan
targets: "http://target.com"
proxy: "http://127.0.0.1:8080"
finger: all

三、POC 漏洞 poc_scan（poc）

示例 3-1：默认 POC（匹配指纹）

tool: poc_scan
targets: "http://test.com"
thread: 20
poc_full: false
include_results: true

CLI： TscanPlus -m poc -u http://test.com

示例 3-2：指定 POC 名称

用户： 用 weblogic 相关 POC 测 http://10.0.0.8:7001。

tool: poc_scan
targets: "http://10.0.0.8:7001"
poc_name: weblogic
thread: 15

CLI： TscanPlus -m poc -u http://10.0.0.8:7001 -pocname weblogic

示例 3-3：全量 POC（高危，需授权）

tool: poc_scan
targets: "http://vuln.com"
poc_full: true
thread: 10
poc_level: "1+2+3"

CLI： TscanPlus -m poc -u http://vuln.com -full -poclevel 1+2+3

示例 3-4：批量 URL 文件场景（Agent 拆分）

用户： 我有 50 个 URL 要打 POC。

Agent：分批逗号传入（每批 ≤20），或建议用户改用 CLI -uf urls.txt。

tool: poc_scan
targets: "http://a.com,http://b.com"
thread: 20

四、弱口令 pwd_crack（crack）

示例 4-1：SSH 单主机

tool: pwd_crack
targets: "192.168.1.1:22"
services: ssh
user: "root,admin"
pwd: "123456,password,admin123"
thread: 2
timeout: 5

CLI： TscanPlus -m crack -h 192.168.1.1 -p 22 -s ssh -user root,admin -pwd 123456,password

示例 4-2：MySQL

tool: pwd_crack
targets: "192.168.1.20:3306"
services: mysql
thread: 1

示例 4-3：多目标多服务

tool: pwd_crack
targets: "10.0.0.1:22,10.0.0.1:3389,10.0.0.2:3306"
services: "ssh,rdp,mysql"
thread: 1

示例 4-4：爆破成功后执行命令

tool: pwd_crack
targets: "192.168.1.1:22"
services: ssh
cmd: "id"
user: root
pwd: "toor,123456"

CLI： TscanPlus -m crack -h 192.168.1.1 -p 22 -s ssh -c "id"

五、子域名 subdomain_scan（domain）

示例 5-1：单域字典枚举

tool: subdomain_scan
domains: "example.com"
sub_api: false
ports: "80,443"
include_results: true

CLI： TscanPlus -m domain -d example.com

示例 5-2：多域 + API（config 已配 key）

tool: subdomain_scan
domains: "example.com,example.org"
sub_api: true
ports: "80,443,8080"

CLI： TscanPlus -m domain -d example.com,example.org -api

示例 5-3：自定义字典

tool: subdomain_scan
domains: "target.com"
sub_dict: "/path/to/subdomains.txt"
sub_api: false

CLI： TscanPlus -m domain -d target.com -dc /path/to/subdomains.txt

六、目录扫描 dir_scan（dir）

示例 6-1：内置字典

tool: dir_scan
urls: "http://test.com"
thread: 30
timeout: 5
include_results: true

CLI： TscanPlus -m dir -u http://test.com

示例 6-2：自定义字典 + 高线程

tool: dir_scan
urls: "https://test.com"
dict: "/path/to/dirlist.txt"
thread: 50

CLI： TscanPlus -m dir -u https://test.com -dd /path/to/dirlist.txt -ds 50

七、JS 敏感信息 js_scan（js）

示例 7-1：单站 JS 收集

tool: js_scan
urls: "https://test.com"
timeout: 10
include_results: true

CLI： TscanPlus -m js -u https://test.com -wt 10

示例 7-2：多 URL

tool: js_scan
urls: "https://a.com,https://b.com"
proxy: "socks5://127.0.0.1:1080"

八、空间测绘 cyber_search（cyber）

须在 config.yaml 配置 Hunter/FOFA 等引擎与 Key。

示例 8-1：按域名查资产（与 GUI 相同）

tool: cyber_search
query: example.com
field: domain
include_results: true

CLI： TscanPlus -m cyber -ck example.com（或完整语法 -ck 'domain="example.com"' 时需 field=custom）

示例 8-2：按 IP 段

tool: cyber_search
query: 192.168.1.0/24
field: ip

示例 8-3：按标题查（指定引擎）

tool: cyber_search
query: 管理后台
field: title
engines: "hunter,fofa"
include_results: true

示例 8-4：自定义平台语法

tool: cyber_search
query: 'domain="example.com" && port="443"'
field: custom
engines: "fofa"

九、综合扫描 tscan_scan（多模块联动）

联动顺序：cyber → domain → port → crack → url → poc → dir → js

示例 9-1：端口 + Web（最常用）

用户： 对 192.168.1.100 做端口和 Web 指纹，先不要 POC。

tool: tscan_scan
targets: "192.168.1.100"
modules: "port,url"
ports: "Top100"
thread: "300"
url_thread: "50"
finger: tiny
ping_scan: true
include_results: true

CLI： TscanPlus -m port,url -h 192.168.1.100 -finger tiny

示例 9-2：内网 C 段 端口+URL+POC（授权）

tool: tscan_scan
targets: "192.168.1.0/24"
modules: "port,url,poc"
ports: "Top100"
thread: "400"
poc_thread: "15"
finger: tiny
include_results: true
result_limit: 500

CLI： TscanPlus -h 192.168.1.0/24 -m port,url,poc（默认 -m）

示例 9-3：端口 + 弱口令 + POC

tool: tscan_scan
targets: "192.168.1.0/24"
modules: "port,crack,url,poc"
ports: "22,80,443,3306,3389,8080"
crack_services: "ssh,mysql,rdp"
thread: "300"

CLI： TscanPlus -m port,poc,crack -h 192.168.1.0/24 -p 22,80,443,3306,3389,8080

示例 9-4：子域 → 端口 → Web → POC

tool: tscan_scan
targets: "example.com"
domains: "example.com"
modules: "domain,port,url,poc"
sub_api: true
ports: "80,443,8080"
thread: "200"
include_results: true

CLI： TscanPlus -m domain,port,url,poc -d example.com -api

示例 9-5：Web 全链路 url+poc+dir+js

tool: tscan_scan
targets: "http://test.com,http://api.test.com"
modules: "url,poc,dir,js"
finger: tiny
dir_thread: "30"
include_results: true

CLI： TscanPlus -m url,poc,dir,js -u http://test.com,http://api.test.com

示例 9-6：测绘后联动扫描

tool: tscan_scan
targets: target.com
cyber_query: target.com
cyber_field: domain
modules: "cyber,port,url"
ports: "Top100"
thread: "300"

CLI： TscanPlus -m cyber,port,url -ck target.com

示例 9-7：追加端口、排除主机

tool: tscan_scan
targets: "10.0.0.0/24"
modules: "port,url"
ports: "Top100"
ports_add: "3389,5985,6379"
exclude_hosts: "10.0.0.1"
smart_scan: true
thread: "400"

CLI： TscanPlus -m port,url -h 10.0.0.0/24 -pa 3389,5985,6379 -hn 10.0.0.1

示例 9-8：关闭启发式大网段扫描

tool: tscan_scan
targets: "10.0.0.0/16"
modules: "port"
ports: "80,443"
smart_scan: false
thread: "200"

CLI： TscanPlus -m port -h 10.0.0.0/16 -p 80,443 -nosmart

十、项目管理

示例 10-1：默认 MCP 项目（每次清空）

未传 project 时自动使用 MCP 并在调用前清空，适合一次性对话扫描。

示例 10-2：命名项目、累积结果

tool: subdomain_scan
domains: "example.com"
project: pentest-acme
# fresh_project 默认 false → 追加

示例 10-3：清空后重扫

tool: ip_scan
target: "10.0.0.0/24"
ports: "Top100"
project: pentest-acme
fresh_project: true

示例 10-4：综合项目登记

tool: tscan_scan
targets: "192.168.1.0/24"
modules: "port,url,poc"
project: pentest-acme
fresh_project: true

tscan_scan 会在 GUI project 表登记；单工具可能仅写分表。

十一、分阶段工作流（推荐 Agent 策略）

工作流 A：IP → Web → 漏洞

  1. ip_scan：ports: "80,443,8080,8443"
  2. 从 results.ipscan 提取 target URL
  3. url_scan：finger: tiny
  4. 用户确认后 poc_scan 或 tscan_scan 仅 poc 模块

工作流 B：子域资产扩张

  1. subdomain_scan + sub_api: true
  2. tscan_scan：modules: "port,url"，targets 为子域列表
  3. 对高危 URL 单独 poc_scan

工作流 C：测绘驱动

  1. cyber_search 获取 IP/域名
  2. 向用户展示摘要，确认范围
  3. ip_scan / url_scan 分批执行（控制 result_limit）

十二、拒绝未授权扫描

用户： 扫一下 https://www.baidu.com 有没有漏洞。

Agent 应：

说明无法对未授权的第三方生产站点执行扫描；可改为在用户自有 lab 靶机上演示 poc_scan 参数与返回结构，不进行真实请求。

十三、返回 JSON 结构参考

{
  "success": true,
  "message": "ip_scan completed",
  "data": {
    "project": "MCP",
    "project_cleared": true,
    "target": "10.211.55.2",
    "ports": "80,443,8080",
    "result_limit": 200,
    "counts": { "ipscan": 3, "urlscan": 1, "poccheck": 0 },
    "results": {
      "ipscan": [
        {
          "host": "10.211.55.2",
          "port": "8083",
          "target": "http://10.211.55.2:8083",
          "title": "..."
        }
      ],
      "urlscan": [],
      "poccheck": []
    }
  }
}

各表关键字段（汇报时优先提取）：

表名 字段
ipscan host, port, target, title, banner
urlscan target, title, finger, status
poccheck target, poc_vul, level, request
pwdcrack host, port, service, user, pass
dirscan url, path, status, len
jsfinder url, match, type
subdomain domain, subdomain, ips
cyber ip, domain, port, title, source

十四、CLI 批量对照（无 MCP 时）

# C 段全面（慎用范围）
TscanPlus -h 192.168.1.0/24 -m port,url,poc,crack

# URL 文件
TscanPlus -uf target-urls.txt -m url,poc,dir,js

# 全功能（lab 仅限）
TscanPlus -h 192.168.1.0/24 -d example.com -m port,url,poc,crack,dir,js,domain,cyber

# 指定项目
TscanPlus -pr MyProject -m port,url,poc -h 192.168.1.1

Agent 在 MCP 可用时应优先调用工具并解析 JSON，CLI 仅作备选说明。

Reference in New Issue View Git Blame Copy Permalink