What’s New in v2.2

cti-expert/
├── SKILL.md                       Command reference & skill definition
├── README.md                      This file
│
├── engine/                        Case data model & state management
│   ├── subject-registry.md        How subjects are tracked
│   ├── finding-framework.md       Finding lifecycle & evidence chains
│   ├── workspace-format.md        Workspace serialization spec
│   └── conflict-resolver.md       CONTESTED finding resolution
│
├── techniques/                    Collection techniques (32 files)
│   ├── whois-universal.md         Universal multi-TLD WHOIS cascade
│   ├── web-collection-scrapling.md Scrapling adaptive web collection
│   ├── agentflow-enrichment.md    Parallel enrichment orchestration
│   ├── fx-metadata-parsing.md, fx-image-verification.md, ...
│   ├── username-osint.md, phone-osint.md, email-osint.md
│   ├── cloud-audit.md, dependency-audit.md, disk-forensics.md
│   └── ...
│
├── experience/                    UX, tiers, guided flows
│   ├── guided-flows/              Interactive workflows
│   ├── case-templates/            Pre-built case templates
│   └── accessibility/             Glossary, low-jargon mode
│
├── analysis/                      Pattern detection & intelligence engines
│   ├── deviation-detector.md      Behavioral anomaly detection
│   ├── cross-reference-engine.md  Shared identifier detection
│   └── exposure-model.md          Risk score calculation
│
├── output/                        Report & visualization specs
│   ├── reports/                   Report templates
│   └── visuals/                   Chart & render engine specs
│
├── scripts/                       DOCX report generation
│   ├── generate-cti-docx.py       Main generator
│   ├── cti_docx_charts.py         Chart rendering
│   ├── cti_docx_diagrams.py       Entity relationship diagrams
│   └── requirements.txt           Python dependencies
│
├── workflows/                     Professional use-case guides
│   ├── wf-journalist.md           Journalist source verification
│   ├── wf-threat-analyst.md       Cyber threat intelligence
│   └── wf-hr-screening.md        Background checks
│
├── guides/walkthroughs/           Worked case examples
│   ├── walkthrough-person-lookup.md
│   ├── walkthrough-domain-sweep.md
│   └── walkthrough-username-trace.md
│
└── validation/                    Quality assurance
    ├── coverage-matrix.md         Investigation area coverage
    ├── quality-scoring.md         Finding scoring methodology
    └── verification-checklist.md  Evidence chain validation

Adding techniques:

1. Create techniques/fx-[name].md with method description, free tool lists, limitations

Workflow improvements:

1. Document in workflows/ with success criteria

Pull request process:

1. Fork and create feature branch: git checkout -b feature/technique-name
2. Document changes in SKILL.md and README.md
3. Test on at least 3 real-world targets
4. Submit PR with description

Bug reports: File issues with command output, environment, and target type.

CTI Expert là gì?

Một kỹ năng của Claude Code biến Claude thành một nhà phân tích tình báo mối đe dọa mạng và tình báo nguồn mở chuyên nghiệp. Chạy thu thập tình báo có cấu trúc sử dụng 67+ lệnh trên 35 kỹ thuật — không cần API key cho chức năng cốt lõi. Một số kỹ thuật hỗ trợ API key miễn phí tùy chọn để truy cập nâng cao (VD: Wigle, VirusTotal, URLScan.io).

Mới trong v2.2: Pháp y hình ảnh & tìm kiếm khuôn mặt (FaceCheck.id, TinEye, FotoForensics, picarta.ai AI geolocation), điều tra blockchain (Blockchair, Etherscan, WalletExplorer, Chainabuse), theo dõi vận tải (ADS-B Exchange theo dõi máy bay, Marine Traffic theo dõi tàu, VIN decoder), điều tra darknet (Ahmia.fi tìm kiếm Tor, ransomwatch), mạng xã hội mở rộng (Reddit, Instagram, TikTok, Telegram), tra cứu người (TruePeopleSearch, IDCrawl), 11 mẫu Google mega-dork bao phủ 73 domain.

Mới trong v2.1: Trực quan hóa đường tấn công (/cti-expert /render threat-path), bề mặt tấn công (/cti-expert /render attack-surface), xuất IOC STIX 2.1 (/cti-expert /report ioc), theo dõi rủi ro theo thời gian (/cti-expert /drift), ảnh chụp Wayback (/cti-expert /snapshots, /cti-expert /diff), hướng dẫn người mới (/cti-expert /onboard), giải thích phát hiện (/cti-expert /clarify), phân tích khoảng trống (/cti-expert /blind-spots), kiểm tra nguồn (/cti-expert /source-check), so sánh phiên (/cti-expert /workspace diff), điểm chất lượng (/cti-expert /quality), thang độ tin cậy nguồn A-F, 4 loại thực thể mới.

Khả năng cốt lõi: Trinh sát đa vector trên mọi loại mục tiêu (cá nhân, tên miền, tổ chức, tên người dùng, email, IP, WiFi) với xác thực phát hiện tự động, chấm điểm rủi ro phơi bày, và báo cáo tình báo có cấu trúc ở nhiều định dạng.

Quy trình: Vòng đời AEAD — Thu thập dữ liệu thô → Làm giàu bằng mở rộng pivot → Đánh giá phát hiện → Phân phối báo cáo có cấu trúc (Markdown + Word với biểu đồ, sơ đồ, định dạng chuyên nghiệp).

Cài đặt

Khuyến nghị: Dùng Claude Code CLI — cho phép sử dụng đầy đủ workflow terminal, phiên làm việc liên tục và gọi skill trực tiếp. Tải tại đây hoặc chạy npm install -g @anthropic-ai/claude-code.

Tại sao nên dùng Claude Code CLI?

Toàn bộ workflow CTI Expert được tối ưu cho Claude Code CLI:

• Phiên làm việc liên tục — điều tra được lưu qua /cti-expert /workspace save
• Truy cập đầy đủ công cụ — ghi file, chạy Python, tạo DOCX, tất cả chạy tự nhiên
• Gọi skill trực tiếp — gõ /cti-expert ngay trong terminal
• Agent song song — AgentFlow hoạt động tốt nhất với CLI

Bước 1 — Cài đặt Claude Code CLI

npm install -g @anthropic-ai/claude-code

Yêu cầu Node.js 18+. Tài liệu đầy đủ: docs.anthropic.com/en/docs/claude-code/overview

Bước 2 — Clone + Cài đặt all-in-one

Script scripts/install.sh xử lý tất cả: Python venv, công cụ hệ thống (whois, dig, jq, exiftool), công cụ OSINT (maigret, sherlock, holehe, h8mail, …), và tùy chọn headless browser + Go tools.

git clone https://github.com/7onez/cti-expert.git ~/.claude/skills/cti-expert
bash ~/.claude/skills/cti-expert/scripts/install.sh

git clone https://github.com/7onez/cti-expert.git ~/.claude/skills/cti-expert
bash ~/.claude/skills/cti-expert/scripts/install.sh

git clone https://github.com/7onez/cti-expert.git "$env:USERPROFILE\.claude\skills\cti-expert"
pip3 install -r "$env:USERPROFILE\.claude\skills\cti-expert\scripts\requirements.txt"

Người dùng Windows: Script chạy trong Git Bash (đi kèm Git for Windows) hoặc WSL. PowerShell là phương án dự phòng chỉ cài Python dependencies.

Tùy chọn installer

bash scripts/install.sh               # Cơ bản: Python + công cụ hệ thống + OSINT tools
bash scripts/install.sh --headless    # + Scrapling headless browser (~200MB Chromium)
bash scripts/install.sh --go          # + Go tools (subfinder, amass, gau, gitleaks, httpx)
bash scripts/install.sh --all         # + Tất cả

Kiểm tra cài đặt

claude   # mở Claude Code CLI
# sau đó gõ:
/cti-expert

Tùy chọn khác — Claude Code Desktop (macOS / Windows)

Tải về: claude.ai/download — hỗ trợ macOS và Windows

1. Cài đặt Claude Code Desktop — Tải từ claude.ai/download và cài đặt ứng dụng

2. Tải CTI Expert — Vào kho GitHub, nhấn nút “Code” màu xanh, sau đó chọn “Download ZIP”

3. Giải nén vào thư mục skills — Giải nén file đã tải, di chuyển thư mục vào thư mục skills và đổi tên thành cti-expert:

   Hệ điều hành	Cách điều hướng
   macOS	Mở Finder → Nhấn Cmd + Shift + G → Nhập ~/.claude/skills/ → Nhấn Go
   Windows	Mở File Explorer → Nhập %USERPROFILE%\.claude\skills\ vào thanh địa chỉ → Nhấn Enter

4. Chạy installer — Mở terminal trong Claude Code Desktop:

   bash ~/.claude/skills/cti-expert/scripts/install.sh

   Hoặc trên Windows PowerShell (chỉ Python):

   pip3 install -r "$env:USERPROFILE\.claude\skills\cti-expert\scripts\requirements.txt"

5. Khởi động lại Claude Code Desktop — Đóng và mở lại ứng dụng

6. Xác nhận — Gõ /cti-expert trong chat để xác nhận skill đã được tải

Bắt đầu nhanh

/cti-expert /case example.com                   # Chạy case tự động hoàn toàn
/cti-expert /flow person                        # Quy trình điều tra cá nhân
/cti-expert /flow domain                        # Quy trình trinh sát tên miền
/cti-expert /sweep @username                    # Trinh sát đa vector trên handle
/cti-expert /query example.com                  # 12-15 truy vấn tìm kiếm nâng cao
/cti-expert /username johndoe                   # Liệt kê nền tảng (3000+)
/cti-expert /email-deep user@domain.com         # Điều tra email chuyên sâu
/cti-expert /exposure domain.com                # Điểm rủi ro tổng hợp (0-100)
/cti-expert /report                             # Báo cáo kỹ thuật INTSUM
/cti-expert /workspace save                     # Lưu workspace + tự động tạo .docx

Tính năng theo lĩnh vực

Đạo đức & Sử dụng có trách nhiệm

Kỹ năng này chỉ dành cho nghiên cứu hợp pháp và điều tra bảo mật chuyên nghiệp.

Được phép: Xác minh nguồn báo chí, sàng lọc nhân sự (có sự đồng ý), nghiên cứu bảo mật doanh nghiệp, kiểm tra xâm nhập được ủy quyền, điều tra pháp lý/tuân thủ, giám sát danh tiếng cá nhân.

Cấm: Doxxing, quấy rối, theo dõi, giám sát trái phép, kỹ thuật xã hội, gian lận, vi phạm quyền riêng tư, hoạt động tội phạm.

Tác giả: Hieu Ngo • hieu.ngo@chongluadao.vn • Phiên bản: 2.2 • Giấy phép: MIT

什么是 CTI Expert？

一个 Claude Code 技能，将 Claude 转变为���练有素的网络威胁情报和开源情报分析师。使用 67+ 个命令、35 种技术进行结构化情报收集——核心功能无需 API 密钥。部分技术支持可选的免费 API 密钥以获取增强访问（如 Wigle、VirusTotal、URLScan.io）。

v2.2 新功能： 图像取证与人脸搜索（FaceCheck.id、TinEye、FotoForensics、picarta.ai AI地理定位）、区块链调查（Blockchair、Etherscan、WalletExplorer、Chainabuse）、交通追踪（ADS-B Exchange飞机追踪、Marine Traffic船舶追踪、VIN解码器）、暗网调查（Ahmia.fi Tor搜索、ransomwatch）、社交媒体扩展（Reddit、Instagram、TikTok、Telegram）、人员搜索（TruePeopleSearch、IDCrawl）、11个跨平台Google mega-dork模板覆盖73个域名。

v2.1 新功能： 攻击路径可视化（/cti-expert /render threat-path）、攻击面映射（/cti-expert /render attack-surface）、STIX 2.1 IOC 导出（/cti-expert /report ioc）、时间风险追踪（/cti-expert /drift）、Wayback 快照（/cti-expert /snapshots、/cti-expert /diff）、新手引导（/cti-expert /onboard）、发现解释（/cti-expert /clarify）、盲点分析（/cti-expert /blind-spots）、来源检查（/cti-expert /source-check）、会话比较（/cti-expert /workspace diff）、质量评分（/cti-expert /quality）、来源可靠性 A-F 等级、4 种新实体类型。

核心能力： 对任何目标类型（个人、域名、组织、用户名、电子邮件、IP、WiFi）进行多向量侦察，具备自动发现验证、暴露风险评分，以及多格式结构化情报交付。

工作流程： AEAD 生命周期——获取原始数据 → 通过枢轴扩展丰富 → 评估发现 → 交付结构化报告（Markdown + 带图表、图形、专业格式的 Word 文档）。

安装

推荐： 使用 Claude Code CLI — 提供完整的终端工作流、持久会话和直接技能调用。点击下载 或运行 npm install -g @anthropic-ai/claude-code。

为什么推荐 Claude Code CLI？

整个 CTI Expert 工作流针对 Claude Code CLI 进行了优化：

• 持久会话 — 调查通过 /cti-expert /workspace save 跨重启保存
• 完整工具访问 — 文件写入、Python 脚本、DOCX 生成均原生运行
• 直接调用技能 — 在终端中直接输入 /cti-expert
• 并行 Agent — AgentFlow 在 CLI 下运行效果最佳

第一步 — 安装 Claude Code CLI

npm install -g @anthropic-ai/claude-code

需要 Node.js 18+。完整文档：docs.anthropic.com/en/docs/claude-code/overview

第二步 — 克隆 + 一键安装

scripts/install.sh 安装脚本处理所有内容：Python venv 依赖、系统工具（whois、dig、jq、exiftool）、OSINT 工具（maigret、sherlock、holehe、h8mail 等），以及可选的无头浏览器和 Go 工具。

git clone https://github.com/7onez/cti-expert.git ~/.claude/skills/cti-expert
bash ~/.claude/skills/cti-expert/scripts/install.sh

git clone https://github.com/7onez/cti-expert.git ~/.claude/skills/cti-expert
bash ~/.claude/skills/cti-expert/scripts/install.sh

git clone https://github.com/7onez/cti-expert.git "$env:USERPROFILE\.claude\skills\cti-expert"
pip3 install -r "$env:USERPROFILE\.claude\skills\cti-expert\scripts\requirements.txt"

Windows 用户： 安装脚本在 Git Bash（随 Git for Windows 附带）或 WSL 中原生运行。PowerShell 是仅安装 Python 依赖的备用方案。

安装选项

bash scripts/install.sh               # 基础：Python 依赖 + 系统工具 + OSINT 工具
bash scripts/install.sh --headless    # + Scrapling 无头浏览器（~200MB Chromium）
bash scripts/install.sh --go          # + Go 工具（subfinder、amass、gau、gitleaks、httpx）
bash scripts/install.sh --all         # + 以上所有内容

验证安装

claude   # 打开 Claude Code CLI
# 然后输入：
/cti-expert

备选方案 — Claude Code 桌面版（macOS / Windows）

下载：claude.ai/download — 支持 macOS 和 Windows

1. 安装 Claude Code 桌面版 — 从 claude.ai/download 下载并安装应用

2. 下载 CTI Expert — 访问 GitHub 仓库，点击绿色 “Code” 按钮，然后选择 “Download ZIP”

3. 解压到 skills 文件夹 — 解压文件，将文件夹重命名为 cti-expert 并移动到：

   操作系统	路径
   macOS	~/.claude/skills/ （Finder → Cmd+Shift+G）
   Windows	%USERPROFILE%\.claude\skills\ （文件资源管理器地址栏）

4. 运行安装脚本 — 在 Claude Code Desktop 终端中运行：

   bash ~/.claude/skills/cti-expert/scripts/install.sh

   或在 Windows PowerShell（仅 Python）：

   pip3 install -r "$env:USERPROFILE\.claude\skills\cti-expert\scripts\requirements.txt"

5. 重启 Claude Code 桌面版 — 关闭并重新打开应用

6. 验证 — 输入 /cti-expert 确认技能已加载

快速入门

/cti-expert /case example.com                   # 完全自动案例
/cti-expert /flow person                        # 人员调查流程
/cti-expert /flow domain                        # 域名侦察流程
/cti-expert /sweep @username                    # 对账号进行多向量侦察
/cti-expert /query example.com                  # 12-15 个高级搜索查询
/cti-expert /username johndoe                   # 平台枚举（3000+）
/cti-expert /email-deep user@domain.com         # 深度电子邮件调查
/cti-expert /exposure domain.com                # 综合风险评分（0-100）
/cti-expert /report                             # 技术 INTSUM 报告
/cti-expert /workspace save                     # 保存工作空间 + 自动生成 .docx

功能领域

道德与负责任使用

此技能仅用于合法研究和专业安全调查。

允许： 新闻事实核查、人力资源筛选（需征得同意）、企业安全研究、授权渗透测试、法律/合规调查、个人声誉监控。

禁止： 人肉搜索、骚扰、跟踪、未授权监控、社会工程、欺诈、隐私侵犯、犯罪活动。

作者： Hieu Ngo • hieu.ngo@chongluadao.vn • 版本： 2.2 • 许可证： MIT