Skip to content
Back to search

network-doctor

MarketplaceWorks with Claude CodeGitHub

Find out why your internet feels bad, and fix it at the router.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dav-ayman--network-doctor/badge.svg)](/listings/dav-ayman--network-doctor)

HTML

<a href="/listings/dav-ayman--network-doctor"><img src="/api/listings/dav-ayman--network-doctor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code**

/plugin marketplace add dav-ayman/network-doctor
/plugin install network-doctor@network-doctor

You get the skill and the MCP tools.

**Claude Desktop**

1. Download `network-doctor-<version>.mcpb` from [Releases](https://github.com/dav-ayman/network-doctor/releases/latest). 2. Double-click it, or go to Settings > Extensions and drag it in. 3. Click Install.

It runs locally on your computer, so it can see your real Wi-Fi and router. A cloud sandbox can't.

Then just describe the problem: *"my calls keep breaking up"*, *"why is my Wi-Fi so slow?"*, *"check my 5G router's signal"*.

There's nothing to `pip install`. It's Python 3.9+ standard library only, and runs on macOS (first class) and Linux. On macOS, `python3` comes with the Xcode command line tools (`xcode-select --install`).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 22 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "network-doctor",
  4. "description": "Find out why your internet feels bad, and fix it at the router.",
  5. "owner": {
  6. "name": "dav-ayman",
  7. "url": "https://github.com/dav-ayman"
  8. },
  9. "plugins": [
  10. {
  11. "name": "network-doctor",
  12. "description": "Diagnose bad internet end to end (Wi-Fi, bufferbloat, call quality, MTU, DNS, 4G/5G signal) and read or tune home routers: Huawei, ZTE, TP-Link, ASUS, FRITZ!Box, MikroTik, OpenWrt.",
  13. "version": "0.1.0",
  14. "author": { "name": "dav-ayman", "url": "https://github.com/dav-ayman" },
  15. "source": "./plugins/network-doctor",
  16. "category": "productivity",
  17. "homepage": "https://github.com/dav-ayman/network-doctor",
  18. "license": "MIT",
  19. "keywords": ["network", "wifi", "router", "bufferbloat", "latency", "voip", "5g", "lte", "diagnostics"]
  20. }
  21. ]
  22. }
README.md · README · 141 lines
  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="docs/media/banner-dark.svg">
  4. <img alt="network-doctor: why is my internet bad? Ask Claude." src="docs/media/banner-light.svg" width="100%">
  5. </picture>
  6. </p>
  7. <p align="center">
  8. <a href="https://github.com/dav-ayman/network-doctor/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/dav-ayman/network-doctor/actions/workflows/ci.yml/badge.svg"></a>
  9. <img alt="Python 3.9+" src="https://img.shields.io/badge/python-3.9%2B-blue">
  10. <img alt="No dependencies" src="https://img.shields.io/badge/dependencies-none-brightgreen">
  11. <img alt="MIT" src="https://img.shields.io/badge/license-MIT-black">
  12. </p>
  13. <p align="center"><b><a href="https://dav-ayman.github.io/network-doctor/">dav-ayman.github.io/network-doctor</a></b></p>
  14. **network-doctor** is a [Claude Code](https://claude.com/claude-code) plugin that finds out *why* your internet feels bad, then fixes it at the router, with your approval at every step.
  15. > "My voice keeps breaking in meetings."
  16. Instead of guessing, Claude measures:
  17. - your Wi-Fi;
  18. - latency **while your connection is loaded** (the usual reason calls break);
  19. - call quality on the same UDP path Zoom, Teams and Meet use;
  20. - MTU and DNS.
  21. Then it logs in to your router, reading the password from your OS keychain, to read the cellular signal, Wi-Fi channels and QoS. You get ranked findings with evidence. Fixes are proposed, applied only after you say yes, backed up, and re-measured.
  22. <p align="center">
  23. <img alt="netdoc diagnose demo" src="docs/media/diagnose.gif" width="820">
  24. </p>
  25. <p align="center"><a href="docs/media/hero.mp4">▶ Watch the 1-minute overview</a></p>
  26. ## Install
  27. **Claude Code**
  28. ```
  29. /plugin marketplace add dav-ayman/network-doctor
  30. /plugin install network-doctor@network-doctor
  31. ```
  32. You get the skill and the MCP tools.
  33. **Claude Desktop**
  34. 1. Download `network-doctor-<version>.mcpb` from [Releases](https://github.com/dav-ayman/network-doctor/releases/latest).
  35. 2. Double-click it, or go to Settings > Extensions and drag it in.
  36. 3. Click Install.
  37. It runs locally on your computer, so it can see your real Wi-Fi and router. A cloud sandbox can't.
  38. Then just describe the problem: *"my calls keep breaking up"*, *"why is my Wi-Fi so slow?"*, *"check my 5G router's signal"*.
  39. There's nothing to `pip install`. It's Python 3.9+ standard library only, and runs on macOS (first class) and Linux. On macOS, `python3` comes with the Xcode command line tools (`xcode-select --install`).
  40. ## What it checks
  41. <p align="center">
  42. <img alt="diagnosis pipeline" src="docs/media/pipeline.svg" width="820">
  43. </p>
  44. | check | how | catches |
  45. |---|---|---|
  46. | Wi-Fi | RSSI, SNR, channel, width, neighbouring networks | weak signal, crowded 2.4 GHz, 40 MHz on 2.4 GHz |
  47. | Local link | router ping at 5/s | Wi-Fi dropouts, retries, bad cables |
  48. | **Latency under load** | call probe idle vs during upload vs during download | **bufferbloat**, graded A+ to F |
  49. | Call quality | UDP STUN at 10 packets/s | loss, jitter, packets too late for voice |
  50. | MTU | DF-ping binary search | PPPoE/VPN black holes |
  51. | DNS | lookup times | slow or failing resolvers |
  52. | Router | vendor API, read-only by default | 4G/5G RSRP/RSRQ/SINR/band, Wi-Fi config, clients, QoS/SQM |
  53. <p align="center">
  54. <img alt="call quality while uploading" src="docs/media/call-under-load.gif" width="820">
  55. </p>
  56. ## Supported routers
  57. | family | covers | tier |
  58. |---|---|---|
  59. | Huawei HiLink | 5G CPE 5s/Pro, B310-B818, E5577/E5785 MiFi, E3372 | ✅ verified |
  60. | ZTE goform | U20, MU5001, MF971 and most ZTE MiFis | ✅ verified |
  61. | ZTE ZXHN | H188A (verified), H298A, F670L and ISP-branded gateways | ✅ verified |
  62. | Huawei home gateway | HG630 V2 (verified), HG633, HG658 | ✅ verified |
  63. | TP-Link Archer | AX/C-series "luci" web UI (signed-AES and RSA logins) | 🧪 experimental |
  64. | TP-Link LTE | Archer MR200/MR600, TL-MR6400/MR6500 | 🧪 experimental |
  65. | TP-Link legacy | older TL-WR / Archer `/userRpm/` UI (read-only) | 🧪 experimental |
  66. | ASUS | ASUSWRT / Asuswrt-Merlin | 🧪 experimental |
  67. | AVM FRITZ!Box | TR-064 | 🧪 experimental |
  68. | MikroTik | RouterOS 7 REST, including LTE monitor | 🧪 experimental |
  69. | OpenWrt | ubus JSON-RPC (LuCI builds), SQM status | 🧪 experimental |
  70. **Verified** means a maintainer tested it on real hardware. **Experimental** means it was written from public protocol documentation and tested against synthetic answers.
  71. Have one of these routers? Run `netdoc.py router detect` and tell us if it works. That's how a family becomes verified. Full list: [docs/support-matrix.md](docs/support-matrix.md).
  72. <p align="center">
  73. <img alt="router signal readout" src="docs/media/router.gif" width="820">
  74. </p>
  75. **Router not listed?** `netdoc.py capture` saves a masked snapshot of its web API: page title, headers and API paths, with no secrets, MACs, SSIDs or public IPs. Attach it to an [Add my router](https://github.com/dav-ayman/network-doctor/issues/new?template=router-support.yml) issue. Someone can then write a driver without owning the hardware.
  76. ## Safety
  77. - **Passwords never touch the chat.** You store them yourself in the macOS Keychain or Linux Secret Service, either with `netdoc.py secret set <router-ip>` or in the terminal window that Claude Desktop opens for you. Output is masked: passwords, keys, tokens, IMEI/ICCID and serials.
  78. - **Passwords stay with their router.** Each stored password is tied to the router's hardware (MAC) address. Lots of networks use the same gateway IP, but your home password is never offered to the café's 192.168.1.1.
  79. - **No lockouts.** Routers lock the admin account after 3-10 wrong passwords. A rejected login is remembered, and netdoc refuses to try again until you fix the password and run `router unblock`.
  80. - **Read-only by default.** Writes show a plan first (current value, then new value). They run only with `--apply` after you approve, save a backup, and come with a one-line revert.
  81. - **TP-Link variants it doesn't recognise:** netdoc stops before sending the password.
  82. ## Try it without a router
  83. ```
  84. python3 plugins/network-doctor/skills/network-doctor/scripts/netdoc.py diagnose --demo
  85. ```
  86. `--demo` runs on a synthetic network: a 5G CPE with bufferbloat and crowded 2.4 GHz Wi-Fi. All the screenshots and videos here come from it.
  87. ## CLI
  88. Claude drives the CLI for you. You can also run it directly:
  89. ```
  90. netdoc.py diagnose [--quick] [--json] full checkup with ranked findings
  91. netdoc.py bloat | call [--load up|down] latency under load / call-quality probe
  92. netdoc.py wifi | link | ping | mtu | dns individual checks
  93. netdoc.py router detect | status | get | explore | drivers
  94. netdoc.py router write <target> k=v [--apply] plan, then apply (with backup)
  95. netdoc.py router revert <backup> [--apply]
  96. netdoc.py capture masked API snapshot for issues
  97. netdoc.py secret set|check|delete <ip> keychain (run it yourself)
  98. ```
  99. ## Contributing
  100. Drivers are single files with fixture tests. See [CONTRIBUTING.md](CONTRIBUTING.md). The most valuable contribution is **confirming an experimental driver on your router**.
  101. ## License
  102. MIT. Router vendors' names are used only to describe compatibility. This project isn't affiliated with any vendor.
plugins/network-doctor/skills/network-doctor/scripts/netdoc/mask.py · Bundled script · 88 lines · 1 finding marked
  1. """Masking of secrets and personal identifiers in anything netdoc prints or saves.
  2. Two levels:
  3. - secrets (always): passwords, keys, PSKs, tokens, session ids, IMEI/IMSI/ICCID/MSISDN, serial numbers.
  4. - identifiers (capture/share mode): MAC addresses, SSIDs, public IPs, host names, phone numbers.
  5. """
  6. from __future__ import annotations
  7. import ipaddress
  8. import re
  9. from typing import Any
  10. SECRET_KEY = re.compile(
  11. r"(pass(word|wd|phrase)?|pwd|psk|wpa_?key|wepkey|presharedkey|secret|token|nonce|salt|proof|"
  12. r"sessionid|session_id|sessiontoken|stok|sysauth|cookie|authorization|auth_?token|auth_?key|imei|imsi|iccid|msisdn|serial|sn$|"
  13. r"wifikey|key\d*$|_key$|^key$|pin$|puk$|apikey|private)",
  14. re.I,
  15. )
  16. # Keys that look like secrets by name but are harmless and useful.
  17. SAFE_KEY = re.compile(r"(key_?mgmt|key_?type|encryption\w*|auth_?mode\w*|authentication_?mode|beacontype|tokenexpir\w*|"
  18. r"password_?type|keyindex|key_?index|auth_?type)$", re.I)
  19. IDENT_KEY = re.compile(r"(ssid|mac|bssid|hostname|host_?name|devicename|^name$|phone|number|ipv6|wan_?ip|"
  20. r"public_?ip|externalip|ipaddress|ip_?address)", re.I)
  21. MAC = re.compile(r"\b([0-9A-Fa-f]{2}[:-]){5}[0-9A-Fa-f]{2}\b")
  22. IMEI_LIKE = re.compile(r"\b\d{15,20}\b")
  23. XML_SECRET = re.compile(
  24. r"<(\w*(?:[Pp]assword|PSK|Psk|psk|WpaKey|WepKey|WifiKey|PreSharedKey|[Ss]alt|[Nn]once|[Pp]roof|[Tt]oken|Imei|IMEI|Imsi|IMSI|Iccid|ICCID|"
  25. r"Msisdn|MSISDN|SerialNumber|[Ss]erial)\w*)>[^<]*</\1>"
  26. )
  27. XML_IDENT = re.compile(r"<(\w*(?:Ssid|SSID|Mac|MAC|HostName|Hostname|PhoneNumber|WanIPAddress|WanIPv6Address)\w*)>[^<]*</\1>")
  28. HIDDEN = "<hidden>"
    • Note: Usual in code (tag names in paths and patterns): Contains a <hidden> block, a common wrapper for instructions hidden in a tool description
    • Line 32 on GitHub
  29. def _is_public_ip(s: str) -> bool:
  30. try:
  31. ip = ipaddress.ip_address(s)
  32. except ValueError:
  33. return False
  34. return ip.is_global
  35. def is_secret_key(k: str) -> bool:
  36. k = str(k)
  37. return bool(SECRET_KEY.search(k)) and not SAFE_KEY.search(k)
  38. def mask(obj: Any, identifiers: bool = False) -> Any:
  39. """Return a copy of obj (dict/list/str/number) with secrets (and optionally identifiers) hidden."""
  40. if isinstance(obj, dict):
  41. out = {}
  42. for k, v in obj.items():
  43. if is_secret_key(k) and v not in ("", None, [], {}) and not isinstance(v, (dict, list)):
  44. out[k] = HIDDEN
  45. elif identifiers and IDENT_KEY.search(str(k)) and isinstance(v, str) and v:
  46. out[k] = _ident(v)
  47. else:
  48. out[k] = mask(v, identifiers)
  49. return out
  50. if isinstance(obj, list):
  51. return [mask(v, identifiers) for v in obj]
  52. if isinstance(obj, str):
  53. return mask_text(obj, identifiers)
  54. return obj
  55. def _ident(v: str) -> str:
  56. if MAC.fullmatch(v.strip()):
  57. return "xx:xx:xx:xx:xx:xx"
  58. return "<redacted>"
  59. def mask_text(s: str, identifiers: bool = False) -> str:
  60. s = XML_SECRET.sub(lambda m: f"<{m.group(1)}>{HIDDEN}</{m.group(1)}>", s)
  61. s = IMEI_LIKE.sub("<id>", s)
  62. if identifiers:
  63. s = XML_IDENT.sub(lambda m: f"<{m.group(1)}><redacted></{m.group(1)}>", s)
  64. s = MAC.sub("xx:xx:xx:xx:xx:xx", s)
  65. s = re.sub(r"\b\d{1,3}(?:\.\d{1,3}){3}\b", lambda m: "<public-ip>" if _is_public_ip(m.group(0)) else m.group(0), s)
  66. return s
  67. def scrub_known(s: str, secrets: list) -> str:
  68. """Last line of defence: remove any literal secret values we know about from text output."""
  69. for sec in secrets:
  70. if sec and len(sec) >= 4:
  71. s = s.replace(sec, HIDDEN)
  72. return s

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.