Skip to content
TakoAPI
Back to skills

nas-master

by afajohn

Self-Hosted & Automation
1.8kDownloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

A hardware-aware, hybrid (SMB + SSH) suite for ASUSTOR NAS metadata.

Description

What This Skill Does

A hybrid SMB and SSH scraping suite for ASUSTOR NAS devices that indexes files, captures metadata, and extracts system-level data like RAID status and Btrfs integrity. Enforces strict read-only access and CPU throttling tuned for i3-10th Gen hardware. Results are written to a MySQL database and surfaced through a PHP/AJAX dashboard via XAMPP.

Combines SMB file crawling with SSH system access in a single automated pipeline, with built-in hardware throttling and scan-resume support that generic scraping scripts lack.

When to Use It

  • Building a searchable inventory of all files across NAS volumes
  • Auditing Windows ACLs and Linux permissions on an ASUSTOR NAS
  • Checking RAID health and Btrfs scrub status without manual SSH
  • Running background NAS scans without degrading desktop performance
  • Generating a local web dashboard to browse and filter scraped NAS data

Example Workflow

INPUT

User asks: Scan all my NAS volumes and build a searchable file dashboard

AGENT
  1. 1

    Connects to NAS volumes via SMB using NAS_USER and NAS_PASS credentials

  2. 2

    Recursively scans every folder with pathlib generators, capturing name, path, size, extension, and ACLs

  3. 3

    Opens SSH session to extract RAID levels from /proc/mdstat and Btrfs scrub status

  4. 4

    Writes all records to MySQL with INSERT IGNORE to safely resume interrupted scans

  5. 5

    Generates a PHP/AJAX dashboard in C:\xampp\htdocs\nas_explorer\

OUTPUT

Searchable NAS file explorer at localhost/nas_explorer with full metadata, permissions, and system health data

Requirements

  • ASUSTOR NAS device with ADM
  • XAMPP installed (provides PHP, MySQL, and Apache for the dashboard)
  • Environment variables: NAS_VOLUMES, NAS_USER, NAS_PASS, NAS_SSH_HOST, NAS_SSH_USER, NAS_SSH_PASS, DB_PASS

Installation

clawhub install afajohn/nas-master

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links