tidesec/tscanplus/tscanplus-skill
- community
Checking that the SKILL.md file is still in the repository.
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, ak_verify, jwt_decode, jwt_crack, OSS bucket (anonymous/endpoint/oss_path), cloud AK leak credential check, or recon on IPs, domains, or URLs in any AI assistant with MCP support.
Install
npx vskill@latest install tidesec/tscanplus/tscanplus-skillSKILL.md
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/爆破。
单任务与多目标（强制）
无影 MCP 扫描为 单项目单任务：
- 支持：一次工具调用传入多个 URL / IP / 域名（逗号或换行），在同一任务内检测。
- 不支持：并行多次
tools/call（同时跑多个dir_scan/url_scan/ip_scan等）。 - 多个站点优先 合并进一次调用，不要拆成并行任务。
- 若其他扫描仍在执行：先等待一段时间再调用。扫描类工具共用闸门，后到的调用最多等 15 秒；超时返回错误，文案含 「请合并 URL 或等当前任务结束」。此时不要立刻再并行重试，应合并目标或等当前任务结束后再调。
- 不受闸门限制：
jwt_decode/jwt_crack/ak_verify。
产品能力概览
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） | |
| AK 泄露验证 | —（GUI AK管理） | ak_verify | OSS（含匿名桶 / 自定义 Endpoint）/云主机/微信/钉钉/飞书/地图/海康萤石/听云/百度人脸/绿盟 凭据 API 验证 | |
| JWT 解码/爆破 | jwt decode / jwt crack | jwt_decode / jwt_crack | 对齐 GUI JwtCrack；默认字典 config/jwt.txt |
多模块联动使用 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 | |
| 已知 URL 打 POC | poc_scan | targets 逗号分隔；慎用 poc_full | |
| 弱口令 | pwd_crack | targets: 192.168.1.1:22,192.168.1.1:3306 | |
| 目录 / JS | dir_scan / js_scan | 完整 URL，多个 URL 一次传入，勿并行多次调用 | |
| 子域名 | subdomain_scan | domains；API 需 config | |
| 空间测绘 | cyber_search | query 对齐 -ck | |
| 多阶段、结果传递 | tscan_scan | 大任务可分阶段执行 | |
| 云 AK 泄露验证 | ak_verify | kind=oss/server/...；OSS 支持匿名桶 URL、自定义 Endpoint、阿里云 oss_path | |
| JWT 解码 | jwt_decode | 解析 Header/Payload/Signature | |
| JWT 密钥爆破 | jwt_crack | 默认 config/jwt.txt，可自定义 dict 或内联 secrets |
通用参数（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 | 内置字典 | 多对多 | |
pair | -pair | false | 启用一账一密（一对一） | |
pairf | -pairf | — | 一对一字典文件，每行 user:pass | |
pair_dict | — | — | 一对一内联字典（换行分隔 user:pass） | |
cmd | -c | whoami | 成功后执行命令 | |
thread | -br | 1 | 爆破线程 | |
timeout | -time | 3 |
字典模式： 默认多对多（账号×密码笛卡尔积）。一账一密时只用 user:pass 配对尝试；指定 pair/pairf/pair_dict（或 CLI -pair/-pairf）即启用。与 user/pwd 同时出现时以一对一为准。
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. AK 泄露 API 验证 ak_verify（GUI「AK管理」）
对齐 GUI AK管理 全部 Tab：用官方 API 校验泄露凭据是否仍可用。
`kind` 一览：
kind | GUI Tab | 验证方式 | |
|---|---|---|---|
oss | OSS存储管理 | 列存储桶；匿名桶 URL 验活；自定义 Endpoint / 低权限 oss_path | |
server | 云主机管理 | 列举实例 | |
wechat | 微信利用 | 获取 AccessToken | |
dingtalk | 钉钉利用 | 获取 AccessToken | |
feishu | 飞书利用 | 获取 tenant_access_token | |
map | 地图相关 | 调用地图 API（默认地理编码） | |
hikys | 海康萤石 | 云眸/iSecure/萤石验活 | |
tingyun | 听云 | 获取/探测 AccessToken | |
baiduface | 百度人脸 | 获取 AccessToken（可选人脸检测） | |
nsfocus | 绿盟巡检 | UTS 登录 Token / RSAS Basic 编码 |
通用参数：
| MCP 参数 | 默认 | 说明 | |
|---|---|---|---|
kind | 必填 | 见上表 | |
access_key | 多数必填 | 各模块主键（见下「字段映射」） | |
secret_key | 多数必填 | 各模块密钥 | |
fake_ip | — | 伪造客户端 IP（微信/钉钉/飞书/地图/海康/听云/百度/绿盟） | |
include_token | true | 是否返回 access_token（敏感） | |
body_limit | 2000 | 响应 body 截断，最大 8000 |
字段映射（`access_key` / `secret_key`）：
kind | access_key | secret_key | 其他关键参数 | |
|---|---|---|---|---|
oss | AccessKey（匿名可不填） | SecretKey（匿名可不填） | 见下「OSS 扩展」 | |
server | AccessKey | SecretKey | provider 必填；session_token/include_details | |
wechat | AppID / CorpID | AppSecret / CorpSecret | mode: oa（默认）/mini/work | |
dingtalk | AppKey | AppSecret | mode: standard（默认）/exclusive；专属需 domain | |
feishu | App ID | App Secret | 可选 base_url | |
map | API Key | — | service（默认 amap_geocode）；origin/destination | |
hikys | ClientID / AppKey | ClientSecret / AppSecret | provider: hikcloud/isecure/ys7；isecure 需 host；可选 action/fetch_token | |
tingyun | API Key | Secret Key | host 必填；或只传 access_token 探测 | |
baiduface | API Key | Secret Key | 可选 image（Base64，继续人脸检测） | |
nsfocus | 用户名 | 密码 | mode: uts（默认，需 base_url）/scanner（RSAS Basic） |
OSS / 云主机 `provider`：
kind | provider | |
|---|---|---|
oss | aliyun tencent huawei tianyi jdcloud ksyun aws minio baidu qiniu yidong liantong qingcloud upyun | |
server | aliyun tencent jdcloud huawei aws ucloud baidu volcengine tianyi |
OSS 扩展（对齐 GUI「OSS存储管理」）：
| 场景 | 参数 | 说明 | |
|---|---|---|---|
| 长期密钥 | provider + access_key + secret_key | 列存储桶验活 | |
| STS 临时凭据 | 另加 session_token，credential_type=sts | ||
| 自定义 Endpoint | endpoint | MinIO 必填；阿里云及其他厂商可选，如 oss-cn-hangzhou.aliyuncs.com 或 http://127.0.0.1:9000 | |
| 低权限无法列桶 | 阿里云 oss_path | my-bucket 或 my-bucket/data/（与 OSS Browser 路径一致） | |
| 匿名访问 | credential_type=anonymous + bucket_url | 无需密钥，只验证公开桶能否列目录（只读）；provider 可省略，从 URL 识别 | |
| 又拍云 | ext_json.buckets | 服务名列表；ACCESS_KEY=操作员，SECRET_KEY=操作员密码 |
也可把 endpoint / ossPath / bucketUrl / region / buckets 写入 ext_json。独立参数与 ext_json 同时出现时，独立参数覆盖同名字段。
匿名 bucket_url 示例：https://bucket.oss-cn-hangzhou.aliyuncs.com、http://127.0.0.1:9000/bucket。
地图 `service`： amap_walking amap_geocode amap_mp_regeocode tianditu_staticimage tianditu_search tianditu_wmts baidu_web_search baidu_ios_search
响应要点（`data`）：
valid：凭据是否可用- 多数模块：
token（可关）、body、error oss：bucket_count、可选buckets；匿名时access_mode=anonymous、bucket_urlserver：region_count、instance_count、可选instances- 凭据无效时仍返回 JSON（
success: true，valid: false）；参数错误才是工具级错误
授权注意： 仅验证用户明确授权范围内的凭据；不要在对话中完整回显 SecretKey / AppSecret。
10. JWT 解码与爆破 jwt_decode / jwt_crack（GUI「轻武器库 → JwtCrack」）
对齐 GUI JwtCrack 的解码与 HMAC 密钥爆破。默认字典为配置目录下的 jwt.txt（即 config/jwt.txt）。
jwt_decode
| MCP 参数 | CLI | 默认 | 说明 | |
|---|---|---|---|---|
token | -token | 必填 | JWT 字符串 |
响应 data：alg、header、payload（格式化 JSON）、signature（hex）。
CLI： TscanPlus jwt decode -token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
jwt_crack
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingTscanPlus-skill/SKILL.md
Popularity
- Repository stars
- 4,332
- Repository forks
- 247
- 7-day trend score
- 42
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/tidesec/tscanplus/tscanplus-skill)