wpgoldmine

A command-line tool to find WordPress plugin opportunities — large, established plugins weakened by abandonment, low ratings, or poor support, i.e. plugins you could realistically replace or out-build. Powered by wpgoldmine.io; querying runs server-side, so there's nothing to install but the CLI itself.

Usage

npx wpgoldmine search --preset abandoned-plugins --niche forms

Or install globally:

npm install -g wpgoldmine
wpgoldmine presets

Commands

wpgoldmine presets                 List the curated opportunity presets.
wpgoldmine search [options]        Find ranked plugin opportunities.
wpgoldmine plugin <slug>           Opportunity snapshot for one plugin.

search options

| Option | Description | | --- | --- | | --preset <key> | Curated angle, e.g. abandoned-plugins, low-rated-popular, beatable-niche. Composes with --niche. | | --niche <tag> | Narrow to a WordPress.org tag, e.g. seo, forms, backup. | | --ecosystem <name> | wordpress (default) or woocommerce. | | --min-installs <n> / --max-installs <n> | Active-install bounds. | | --max-rating <r> | Max rating on a 0–100 scale (lower = more dissatisfied users). |

Global options

| Option | Description | | --- | --- | | --json | Print raw JSON for scripting / CI. Pipe to jq. | | --base <url> | Override API base (default https://wpgoldmine.io, or $WPGOLDMINE_API_BASE). | | -h, --help / -v, --version | Help / version. |

Set WPGOLDMINE_API_KEY (a WP Goldmine account token, from your account settings) to raise the result limit and unlock extra fields. Without it, the CLI uses the free, capped tier.

export WPGOLDMINE_API_KEY=wpg_your_token_here
wpgoldmine search --preset abandoned-plugins --niche forms --limit 100

Examples

# Abandoned plugins in a specific niche
wpgoldmine search --preset abandoned-plugins --niche forms

# Mid-size, low-rated plugins (proven demand, poor execution)
wpgoldmine search --min-installs 10000 --max-installs 50000 --max-rating 60

# One plugin's opportunity snapshot
wpgoldmine plugin easy-google-fonts

# Scripting: list slugs of low-rated popular plugins
wpgoldmine search --preset low-rated-popular --json | jq -r '.data[].slug'

Use in CI

Because --json is machine-readable, you can wire wpgoldmine into a scheduled job to watch a niche:

wpgoldmine search --preset newest-opportunities --niche ai --json > opportunities.json

GitHub Action

This repo also ships a GitHub Action, so you can run the same queries in a workflow without managing Node yourself.

- id: opportunities
  uses: Bishop81/wpgoldmine-cli@v1
  with:
    args: search --preset abandoned-plugins --niche forms
    output-file: opportunities.json

- run: cat opportunities.json | jq '.data[0]'

| Input | Default | Description | | --- | --- | --- | | args | presets | Arguments for the CLI, e.g. search --preset abandoned-plugins --niche forms. | | json | true | Append --json for machine-readable output. | | api-base | (prod) | Override the API base (WPGOLDMINE_API_BASE). | | output-file | (none) | Also write the output to this path. |

The step output result holds the CLI stdout. A full scheduled example is in examples/watch-niche.yml.

License

MIT