traffic-analysis

Analyze PCAP files to extract network statistics and IOC candidates.

1|1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/chenchunrun/onyx-soc --skill traffic-analysis-chenchunrun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: traffic-analysis
Source: https://github.com/chenchunrun/onyx-soc/tree/main/skills/traffic-analysis
Command: npx skills add https://github.com/chenchunrun/onyx-soc --skill traffic-analysis-chenchunrun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires scapy, and includes scripts (resource) components.

What problem does it solve?

PCAP traffic data is often large and hard to parse manually. This Skill automates the extraction of statistics, protocol distributions, IP/port activity, DNS/HTTP/TLS metadata, and IOC candidates from packet captures to speed up network analysis and incident response.

Core Features & Use Cases

  • Automated extraction of basic statistics (packet count, duration, total bytes)
  • Protocol distribution, IP/port analytics, DNS/HTTP/TLS metadata extraction
  • IOC candidate extraction (IPs, domains, URLs) for rapid enrichment
  • Suitable for threat hunting, incident response, and digital forensics workflows

Quick Start

Run python3 scripts/pcap_analyze.py <capture.pcap> to generate a structured report.

Frequently Asked Questions about traffic-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract IOCs from a PCAP file for incident response?

You can extract IOCs from a PCAP file by running an analysis script that parses packet captures to identify IPs, domains, and URLs. This process outputs structured JSON containing IOC candidates for rapid enrichment during incident response.

What is the best way to automate network traffic analysis from packet captures?

Automating network traffic analysis involves parsing packet captures to extract protocol distributions, IP and port activity, and DNS, HTTP, and TLS metadata. This generates a structured JSON report with basic statistics and network insights.

Do I need tshark installed to analyze PCAP files?

You do not strictly need tshark to analyze PCAP files. The tool relies on tshark for full feature extraction, including TLS SNI and JA3 fingerprints, but provides a Scapy-based fallback for environments without tshark installed.

Can I extract TLS JA3 fingerprints and SNI metadata from PCAP traffic?

Yes, you can extract TLS SNI and JA3 fingerprints from PCAP traffic. The analysis requires tshark to fully parse and extract this TLS info, outputting the metadata alongside protocol distributions and IP statistics in a JSON format.

What network statistics can I generate from a PCAP for threat hunting?

From a PCAP file, you can generate network statistics including packet counts, capture duration, total bytes, protocol distribution, and IP and port analytics. These structured metrics support threat hunting and digital forensics workflows.

Why does my PCAP analysis fail to extract HTTP and DNS queries?

PCAP analysis may fail to extract HTTP and DNS queries if tshark is not installed in your environment. While tshark provides full feature extraction for DNS queries and HTTP requests, a Scapy-based fallback handles basic parsing when it is absent.