NetBox ↔ MikroTik Network Planner
bardiaama/netbox-mikrotik-planner
Planeje redes e gere configs MikroTik a partir de NetBox
Ver no GitHubSkill do Claude Cowork para planejar redes, documentar em NetBox via API e gerar configurações MikroTik RouterOS automaticamente. Cobre três fases: design de endereçamento e topologia, criação de objetos NetBox (sites, devices, interfaces, VLANs), e geração de comandos prontos para RouterOS.
Instalação
npx convez-ai bardiaama/netbox-mikrotik-planner1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Documentar infraestrutura de rede em NetBox e exportar para RouterOS
- Planejar endereçamento IP, VLANs e topologia de roteamento
- Gerar configurações de firewall, PPPoE e BGP para MikroTik
- Automatizar setup de ambientes ISP, datacenter e home lab
Veredito

Ferramenta sólida para quem já trabalha com NetBox e MikroTik. A integração API é bem estruturada, mas requer conhecimento prévio de redes e RouterOS para máximo aproveitamento. Excelente para automatizar o fluxo documentation → deployment em infraestruturas intermediárias ou acima.
README
A tradução para o português deste README ainda está na fila.
NetBox ↔ MikroTik Network Planner
A Claude Cowork skill for planning networks, documenting them in NetBox via API, and generating MikroTik RouterOS configurations from that data.
What it does
- Phase 1 — Plan: Helps design IP addressing, VLAN layout, routing topology, and VPN overlays
- Phase 2 — Document: Creates NetBox objects via REST API (sites, devices, interfaces, prefixes, VLANs, circuits) in the correct dependency order
- Phase 3 — Generate: Pulls data from NetBox and produces ready-to-paste RouterOS commands
Supported environments
| Environment | Details |
|---|---|
| CHR / Cloud | MikroTik CHR on Proxmox, VMware, cloud providers |
| ISP / Carrier | PPPoE, CG-NAT, BGP peering, VRF per customer |
| Enterprise / Datacenter | Rack elevation, OOB management, device roles |
| Home lab | Single-site, tags-based, Proxmox/Docker |
Installation
- Download
netbox-mikrotik-planner.skill - In Claude Cowork, go to Settings → Capabilities → Skills
- Drag and drop the
.skillfile to install
Usage
Once installed, the skill triggers automatically when you mention:
NetBox,IPAM,DCIM,network documentationMikroTik config,RouterOS,generate configIP planning,VLAN design,prefix allocationplan my network,document my infrastructure
Example prompts
I have a NetBox instance at 192.168.1.10:8000.
Help me document my 3-site network with 4 VLANs per site
and generate MikroTik configs for the core routers.
Generate RouterOS firewall rules from my NetBox VLAN segments.
My users are on VLAN 10, servers on VLAN 20, management on VLAN 30.
I'm setting up a small ISP with PPPoE.
Help me plan the address space in NetBox and generate the MikroTik concentrator config.
Structure
netbox-mikrotik-planner/
├── SKILL.md # Main skill instructions
└── references/
├── netbox-api.md # NetBox REST API reference (Python + curl)
└── mikrotik-templates.md # RouterOS config templates from NetBox data
Requirements
- NetBox instance with API access (token required)
- MikroTik RouterOS device (any model or CHR)
- Python
pynetboxorrequestslibrary for automation scripts
Author
Built with Claude Cowork — @bardiaama