snmptrap-receiver

Receive and query SNMP traps from network devices over UDP.

650|182|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/automateyournetwork/netclaw --skill snmptrap-receiver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: snmptrap-receiver
Source: https://github.com/automateyournetwork/netclaw/tree/main/workspace/skills/snmptrap-receiver
Command: npx skills add https://github.com/automateyournetwork/netclaw --skill snmptrap-receiver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Network devices emit SNMP traps for events like link failures and authentication errors, but without a centralized receiver these alerts are lost or scattered, making incident investigation and event correlation difficult.

Core Features & Use Cases

  • Trap Collection: Listen on a UDP port for SNMPv1, SNMPv2c, and SNMPv3 traps sent by routers, switches, and firewalls.
  • Query and Filtering: Search collected traps by type, source IP, OID prefix, or SNMP version, and retrieve full variable binding details for any single trap.
  • Statistics and Monitoring: Check receiver status and get trap counts grouped by type and source for daily summaries.
  • Use Case: After a reported outage, query all linkDown traps from the affected device's IP in the last hour, then pull full trap details to identify the failing interface.

Quick Start

Ask the agent to start the SNMP trap receiver on port 10162 and then show all linkDown traps received in the last hour.

Frequently Asked Questions about snmptrap-receiver

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

FAQPage Schema
How do I receive SNMP traps from network devices?

Start the trap receiver with snmptrap_start_receiver on a UDP port such as 10162, then configure your routers, switches, or firewalls to send traps to that port. Verify incoming traps with snmptrap_get_status.

How to filter SNMP traps by device or trap type?

Use snmptrap_query with filters like source_ip to focus on a specific device, or trap_oid_prefix such as 1.3.6.1.6.3.1.1.5 for standard trap types. Retrieve full variable bindings for any trap with snmptrap_get_trap.

Does the SNMP trap receiver support SNMPv3?

Yes, it supports SNMPv1, SNMPv2c, and SNMPv3 trap formats. However, SNMPv3 requires USM user configuration for full parsing of trap contents.

What are the limitations of an SNMP trap receiver?

This receiver stores traps in memory only, so data is lost on restart. It supports UDP only with no TCP or TLS, runs a single instance per port, and shows OIDs numerically without MIB compilation.

Why is my SNMP trap receiver not getting traps?

Check that the receiver is running with snmptrap_get_status and that devices are configured to send traps to the correct UDP port. Also verify the rate limit and dedup window settings are not dropping incoming traps.