claudegoodies
Skill

sub2api-admin

From Wei-Shaw

Manage Sub2API admin APIs for accounts, redeem codes, groups, proxies, error passthrough rules, TLS fingerprint profiles, imports, exports, batch updates, and raw administrator API calls. Use when the user mentions Sub2API, admin API keys, account management, redeem code management, recharge codes, invitation codes, bulk account import/export, keeping or deleting accounts, refreshing accounts, clearing errors, CRS sync, or managing Sub2API backend settings through the admin API.

Runs a bundled Node CLI that wraps Sub2API admin endpoints for accounts, redeem codes, groups, proxies, and TLS/error rules.

Use it when

  • Managing Sub2API accounts: list, get, refresh, set-schedulable, bulk-update
  • Generating or redeeming Sub2API balance/invitation codes with idempotency keys
  • Bulk importing or exporting Sub2API accounts including credentials
  • Calling undocumented or new Sub2API admin endpoints via raw 'api' command

Skip it if

  • Only useful if you run a Sub2API deployment with admin API key or JWT access
  • Requires Node.js and the bundled scripts/sub2api-admin.js CLI
  • Thin wrapper around Sub2API's admin REST API, not a standalone tool

Facts

Repository
Wei-Shaw/sub2api
Status
Actively maintained
Last commit
Source file
skills/sub2api-admin/SKILL.md

Source preview

The instructions Claude Code reads when this skill runs.

# Sub2API Admin

Use the bundled CLI instead of ad hoc `curl`. Run examples from this skill directory.

```bash
export SUB2API_BASE_URL='https://your-sub2api-host'
export SUB2API_ADMIN_API_KEY='<admin api key>'
# Or, when the deployment uses admin JWT login instead of an admin API key:
# export SUB2API_JWT='<admin access_token>'
node scripts/sub2api-admin.js accounts list
```

For all commands and payload examples, read [references/admin-cli.md](references/admin-cli.md).

## Workflow

1. Reuse `SUB2API_BASE_URL` and either `SUB2API_ADMIN_API_KEY` or `SUB2API_JWT` from the environment.
2. Run read-only commands first: `accounts list`, `accounts get <id>`, `groups all`, or `proxies all`.
3. Before destructive or bulk writes, print the target account names and IDs.
4. Execute the write command only after the target set is clear.
5. Run a follow-up read command to verify the result.

## Common Commands

```bash
node scripts/sub2api-admin.js accounts list --page-size 20
node scripts/sub2api-admin.js accounts get 40
node scripts/sub2api-admin.js accounts usage 40
node scripts/sub2api-admin.js accounts set-schedulable 40 true
node scripts/sub2api-admin.js accounts bulk-update --ids 40,39 --json '{"concurrency":10}'
node scripts/sub2api-admin.js redeem-codes list --page-size 20
node scripts/sub2api-admin.js redeem-codes generate --json '{"count":1,"type":"balance","value":10}' --idempo
View full source on GitHub →

Other skills