lifefloating/keyHunter-skill
A CLI toolkit that finds exposed AI gateway admin panels and tests them for weak credentials, meant only for authorized security research
keyHunter is a Python command-line tool built for studying security weaknesses in AI gateway/quota management panels such as Sub2API, New-API and One-API. It chains together internet search (via FOFA), fingerprinting of live targets, weak-password credential testing, and normalization of the results into JSON files. The project's license and README explicitly restrict its use to systems the user owns or has written authorization to test.
What it does
- Runs a pipeline: FOFA search to find candidate hosts, fingerprinting to confirm which panel type they run, credential testing against a bundled weak-password list (about 489 entries), account data export, and normalization of results into standard JSON artifacts.
- Supports three panel families out of the box: Sub2API (email login), New-API and One-API (username login, with an IDOR-style token/channel access pattern), each with documented login and export endpoints.
- Credential testing follows a fixed order: built-in known combos first, then dictionary passwords per email; it logs but does not exploit non-admin sessions, and by default runs the full credential list unless a max-attempts limit is set.
- Only writes tokens to disk and never prints secrets to the console; a separate validate command checks whether captured tokens are parseable and not expired before treating them as usable.
- Ships as an agentskills.io-compatible SKILL.md so tools like Claude Code or Codex CLI can load it as an automated operating manual.
- The README and a dedicated 'Defensive Security Source License' state the tool is for authorized, defensive academic research only, explicitly banning scanning or credential use against systems without explicit written permission.
Why it matters
This shows how AI-agent-oriented coding tools are now packaging security research workflows as installable 'skills' that agents like Claude Code can execute directly. For readers building or defending AI gateway/quota panels, it's a concrete illustration of the kind of automated reconnaissance and credential-testing pipeline attackers or researchers might use against exposed admin panels, and a reminder that authorization boundaries matter even when a tool is framed as 'defensive'.
Terms in this repo
- FOFA · a search engine that indexes internet-connected devices and services, used to find candidate targets
- fingerprinting · probing a server to identify what software/product it is running
- credential stuffing / spray (撞库) · systematically trying known or common username/password combinations against a login system
- IDOR · Insecure Direct Object Reference, a flaw where changing an ID in a request lets you access another user's data
- JWT · JSON Web Token, a compact signed token format commonly used for login sessions
Repository description (English)
Academic research toolkit for AI gateway panel security studies (Sub2API / New-API / One-API): FOFA discovery, fingerprinting, credential-hygiene testing, artifact normalization. Authorized, defensive use only.
Open on GitHubTrending repos
- vorssaint/vorssaint-utilsOne free menu bar app replaces a dozen paid Mac utilities
- Alishahryar1/free-claude-codeA local proxy that lets coding AI agents run on 49 free or cheap model providers instead of one paid service
- freestylefly/awesome-gpt-image-2A library of 532 reverse-engineered prompts that turn GPT-Image2 into a predictable image-making tool
- block/buzzAn open-source workspace where humans and AI agents chat, code, and review in the same rooms
- NousResearch/hermes-agentNous Research's Hermes is an AI agent that gets smarter the more you use it
- virgiliojr94/book-to-skillA tool that turns technical book PDFs into on-demand reference skills for AI coding agents
- VoltAgent/awesome-agent-skillsA single hub collecting over 1000 'how-to' manuals that make AI coding assistants act like experts
- anthropics/claude-plugins-communityA shared shelf where anyone's Claude add-ons get listed for install