@prowl-ai/prowl-skill 0.5.7 → 0.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +70 -0
- package/README.md +9 -7
- package/package.json +3 -3
- package/plugins/prowl/.claude-plugin/plugin.json +2 -2
- package/plugins/prowl/.codex-plugin/plugin.json +9 -8
- package/plugins/prowl/.mcp.json +1 -1
- package/plugins/prowl/skills/prowl/SKILL.md +12 -10
- package/plugins/prowl-cli/.claude-plugin/plugin.json +2 -2
- package/plugins/prowl-cli/.codex-plugin/plugin.json +7 -7
- package/plugins/prowl-cli/skills/prowl-cli/SKILL.md +15 -14
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,75 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## v0.6.1 – 2026-10-11
|
|
4
|
+
|
|
5
|
+
Package `@prowl-ai/prowl-skill` 0.6.1 · plugins `prowl` 0.5.1, `prowl-cli` 0.3.0.
|
|
6
|
+
|
|
7
|
+
### Security
|
|
8
|
+
|
|
9
|
+
- **The API key is no longer in a process's arguments.** The bundled launcher used to
|
|
10
|
+
start `mcp-remote … --header "Authorization: Bearer <key>"`, so the key sat in argv,
|
|
11
|
+
where any process of the same user reads it with `ps` or `pgrep -fl` — and two Prowl
|
|
12
|
+
keys leaked from one machine exactly that way (2026-10-04, 2026-10-09). The launcher
|
|
13
|
+
now exports `PROWL_MCP_AUTH="Bearer <key>"` and passes the literal
|
|
14
|
+
`Authorization:${PROWL_MCP_AUTH}`, which `mcp-remote` expands from its own
|
|
15
|
+
environment. Key sources and their order are unchanged. `test/mcp_launch_test.js`
|
|
16
|
+
asserts no argument carries the key from any source; `negative-self-test.js` plants
|
|
17
|
+
the old form and watches that assertion fire. Verified live against prowl.chat with
|
|
18
|
+
`mcp-remote` 0.14.3: `initialize` and `tools/list` (23 tools) succeed, the argv shows
|
|
19
|
+
only the placeholder.
|
|
20
|
+
- **Restart running sessions after updating.** An `mcp-remote` already running keeps
|
|
21
|
+
its old argv until its session restarts; rotate a key that was exposed.
|
|
22
|
+
|
|
23
|
+
## v0.6.0 – 2026-09-29
|
|
24
|
+
|
|
25
|
+
Package `@prowl-ai/prowl-skill` 0.6.0 · plugins `prowl` 0.5.0, `prowl-cli` 0.3.0.
|
|
26
|
+
|
|
27
|
+
Real-world market data for your agents. The product changed how it describes itself on
|
|
28
|
+
2026-09-29, and every surface this repository publishes – both skills, four plugin
|
|
29
|
+
manifests, the marketplace and the README – now says the same thing the product does.
|
|
30
|
+
|
|
31
|
+
### Changed
|
|
32
|
+
|
|
33
|
+
- **The headline is market data, and the report is the deep mode.** Both skills lead
|
|
34
|
+
with one MCP endpoint and 444 market data tools across 17 providers (search, ads,
|
|
35
|
+
SEO, app stores, reviews, social, trends, finance), each call billed on its own from
|
|
36
|
+
one USD wallet, every number returned with the tool that produced it.
|
|
37
|
+
`prowl_analyze` is described as what it is – a cross-checked report when one call is
|
|
38
|
+
not enough (up to 16 intelligence modules, 8 without a subscription) – rather than
|
|
39
|
+
as the product. "Market-intelligence tools" becomes "market data tools" everywhere.
|
|
40
|
+
The skill descriptions widen their "Use when" to the product's use cases, including
|
|
41
|
+
trends, app store and review data, and stock quotes and market news.
|
|
42
|
+
- **The catalogue count is 444.** `https://prowl.chat/mcp/skill.md` serves
|
|
43
|
+
`→ 444 API tools` (read 2026-09-29). Eight files said 448, and `npm run check:tools`
|
|
44
|
+
listed each of them. The provider count moves 15 → 17 and "60+ SERP engines" becomes
|
|
45
|
+
102 SearchAPI engines, the figures `prowl-app`'s `mcp_server/_contracts.py` holds.
|
|
46
|
+
- **The starter credit is $15, not $5.** The skill and the README quoted $5, the
|
|
47
|
+
figure from before 2026-09-27; since then signup credit equals one basic report's
|
|
48
|
+
hold.
|
|
49
|
+
- **`brandColor` is `#3f7d5f`** in both Codex manifests. The acid green `#00ff41` is
|
|
50
|
+
retired from the brand.
|
|
51
|
+
- **`defaultPrompt` leads with data**: "Pull Google Trends and news for a keyword"
|
|
52
|
+
replaces "Run a competitive analysis on a domain"; keywords `market-data` and
|
|
53
|
+
`market-research` replace `market-intelligence` and `competitive-analysis`.
|
|
54
|
+
- **The `prowl-cli` page documents CLI `0.3.0`**, whose `--help` states a $5.00 basic
|
|
55
|
+
provider-cost cap (was $2.50) and the wallet holds per tier ($15, $24, $54). The
|
|
56
|
+
page now points at the public docs page that publishes those figures, where it used
|
|
57
|
+
to say none did. **Release `@prowl-ai/cli` 0.3.0 to npm before this version:** the
|
|
58
|
+
release job runs `check-cli.js --release`, which fails on a page that documents a CLI
|
|
59
|
+
npm does not serve.
|
|
60
|
+
|
|
61
|
+
### Fixed
|
|
62
|
+
|
|
63
|
+
- **`check:tools` reads the hosted document in either wording.** Its second server
|
|
64
|
+
anchor matched only `<n> marketing intelligence API tools`; the hosted document is
|
|
65
|
+
moving to `<n> market data tools`, which would have left one anchor and a check that
|
|
66
|
+
says less than it appears to. It now takes both, and the stated-count pattern takes
|
|
67
|
+
both, so a stale figure in the new wording is still caught. Fixtured both ways in
|
|
68
|
+
`test/tool_count_test.js` and `test/contract_test.js`.
|
|
69
|
+
- **`CHANGELOG.md` is no longer read as a current claim.** Every past release states
|
|
70
|
+
the count it shipped with, so the check was red on history. It is skipped by name
|
|
71
|
+
(`HISTORICAL_FILES`), not by a guess about tense.
|
|
72
|
+
|
|
3
73
|
## v0.5.7 — 2026-08-23
|
|
4
74
|
|
|
5
75
|
Package `@prowl-ai/prowl-skill` 0.5.7 · plugins `prowl` 0.4.4, `prowl-cli` 0.2.6
|
package/README.md
CHANGED
|
@@ -1,15 +1,17 @@
|
|
|
1
1
|
# Prowl Plugin
|
|
2
2
|
|
|
3
|
-
**
|
|
3
|
+
**Real-world market data for your agents.** One MCP endpoint, 444 market data tools.
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@prowl-ai/prowl-skill)
|
|
6
6
|
[](https://github.com/PROWL-AI/prowl-skill/actions/workflows/validate.yml)
|
|
7
7
|
[](https://prowl.chat)
|
|
8
8
|
[](https://prowl.chat/mcp)
|
|
9
|
-
[](https://prowl.chat/mcp/skill.md)
|
|
10
10
|
[](LICENSE)
|
|
11
11
|
|
|
12
|
-
[Prowl](https://prowl.chat) is a single MCP endpoint that gives any AI agent (
|
|
12
|
+
[Prowl](https://prowl.chat) is a single MCP endpoint that gives any AI agent (Claude Code, Cursor, Codex or your own stack) **444 market data tools across 17 providers**: search (102 SearchAPI engines), ads, SEO and backlinks, app stores, reviews, social, trends and finance. The agent calls what it needs through `prowl_search_tools` → `prowl_tool_info` → `prowl_call_tool`, each call is billed on its own from one USD wallet, and every number comes back with the tool that returned it.
|
|
13
|
+
|
|
14
|
+
One call for one number. A report when one call is not enough: `prowl_analyze` plans many calls, cross-checks numeric claims against independent tools and composes the result. No agent of your own? Ask Prowl Agent on [prowl.chat](https://prowl.chat), which runs on the same tools.
|
|
13
15
|
|
|
14
16
|
This repo is the **installable plugin**: a namespaced `/prowl:*` skill plus a ready-made MCP config. Install it and your coding agent wires up the rest itself.
|
|
15
17
|
|
|
@@ -31,7 +33,7 @@ Install either or both — the MCP plugin for agent tool calls, the CLI plugin f
|
|
|
31
33
|
|
|
32
34
|
### 1. Get a token (human, one time)
|
|
33
35
|
|
|
34
|
-
1. Sign up at <https://prowl.chat> ($
|
|
36
|
+
1. Sign up at <https://prowl.chat> ($15 starter credit, no card).
|
|
35
37
|
2. Optionally top up the wallet.
|
|
36
38
|
3. Generate a `prowl_...` API key under **MCP Home → API keys & config** (shown once).
|
|
37
39
|
|
|
@@ -95,7 +97,7 @@ codex plugin marketplace add https://github.com/PROWL-AI/prowl-skill
|
|
|
95
97
|
|
|
96
98
|
Then ensure `[plugins."prowl@prowl"] enabled = true` in `${CODEX_HOME:-$HOME/.codex}/config.toml` and restart.
|
|
97
99
|
|
|
98
|
-
The bundled `.mcp.json` connects to `https://prowl.chat/mcp` via `mcp-remote`, reading the token from `PROWL_MCP_TOKEN` or `~/.prowl/prowl_mcp_token`.
|
|
100
|
+
The bundled `.mcp.json` connects to `https://prowl.chat/mcp` via `mcp-remote`, reading the token from `PROWL_MCP_TOKEN` or `~/.prowl/prowl_mcp_token`. The token never appears in a process's arguments: the launcher hands it to `mcp-remote` in the `PROWL_MCP_AUTH` environment variable and passes only the placeholder `Authorization:${PROWL_MCP_AUTH}`, which `mcp-remote` expands itself — so `ps` and `pgrep -fl` show no key.
|
|
99
101
|
|
|
100
102
|
With no key in either place the server **refuses to start** — it prints the two ways to supply one and exits `78` (`EX_CONFIG`). It deliberately does not fall through to `mcp-remote`'s OAuth: that opens a browser and waits on a `localhost` callback, and an MCP server started by an agent is killed long before the consent screen comes back, leaving the operator holding a redirect into a dead port.
|
|
101
103
|
|
|
@@ -109,7 +111,7 @@ Configure a Streamable HTTP MCP server at `https://prowl.chat/mcp` with header `
|
|
|
109
111
|
curl https://prowl.chat/mcp/health
|
|
110
112
|
```
|
|
111
113
|
|
|
112
|
-
Then, from your agent, run `prowl_list_tools` (free) →
|
|
114
|
+
Then, from your agent, run `prowl_list_tools` (free) → 444 tools grouped by category.
|
|
113
115
|
|
|
114
116
|
## The status widget
|
|
115
117
|
|
|
@@ -140,9 +142,9 @@ pruned after seven days, and the plugin never writes to your Claude Code setting
|
|
|
140
142
|
## What your agent gets
|
|
141
143
|
|
|
142
144
|
- **23 MCP tools** front the whole catalog — discovery and schema lookup are free; only data calls are metered.
|
|
145
|
+
- **Reports, when one call is not enough** – `prowl_analyze` plans the calls and composes up to 16 intelligence modules (8 without a subscription). A typed evidence ledger extracts claims, attacks them adversarially, then gap-fills what survives. Contradictions and refuted claims ship inside the report.
|
|
143
146
|
- **3 execution modes** for `prowl_analyze` — `basic` (20–100 calls, 30–90s), `deep` (40–300, 3–5 min, needs Exploit+) and `max` (60–400, 5–10 min, needs Blackops+). A key without the subscription is downgraded to `basic` rather than refused.
|
|
144
147
|
- **8 playbooks** — `geo-visibility-audit`, `competitor-teardown`, `content-engine`, `local-and-reputation`, `mobile-aso`, `amazon-marketplace`, `idea-validation`, `channel-economics-audit`.
|
|
145
|
-
- **Verified reports** — a typed evidence ledger extracts claims, attacks them adversarially, then gap-fills what survives. Contradictions and refuted claims ship inside the report.
|
|
146
148
|
- **Artifacts and exports** — infographic, PDF, PPTX, audio brief and video from `prowl_generate_artifact`; Markdown and HTML from `prowl_export_report`. Both read the report cached against the `session_id` that produced it.
|
|
147
149
|
|
|
148
150
|
Prefer a terminal? Install the `prowl-cli` plugin above, or use [`@prowl-ai/cli`](https://github.com/PROWL-AI/prowl-cli) directly.
|
package/package.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@prowl-ai/prowl-skill",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.1",
|
|
4
4
|
"description": "The Prowl plugin: install/usage skills, the hosted MCP config, and the live status widget that makes a running Prowl call, its progress and its cost visible in the terminal. This package is the installer CLI.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"prowl",
|
|
7
7
|
"mcp",
|
|
8
|
-
"market-
|
|
9
|
-
"
|
|
8
|
+
"market-data",
|
|
9
|
+
"market-research",
|
|
10
10
|
"seo",
|
|
11
11
|
"claude-code",
|
|
12
12
|
"plugin",
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
|
|
3
3
|
"name": "prowl",
|
|
4
4
|
"displayName": "Prowl",
|
|
5
|
-
"description": "
|
|
6
|
-
"version": "0.
|
|
5
|
+
"description": "Real-world market data for your agents: the Prowl skill backed by the hosted Prowl MCP server (444 market data tools across 17 providers), with a status widget that makes a running call, its progress and its cost visible in the terminal.",
|
|
6
|
+
"version": "0.5.1",
|
|
7
7
|
"author": {
|
|
8
8
|
"name": "Prowl",
|
|
9
9
|
"email": "support@prowl.chat",
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
|
|
3
3
|
"name": "prowl",
|
|
4
4
|
"displayName": "Prowl",
|
|
5
|
-
"version": "0.
|
|
6
|
-
"description": "
|
|
5
|
+
"version": "0.5.1",
|
|
6
|
+
"description": "Real-world market data for your agents: the Prowl skill backed by the hosted Prowl MCP server (444 market data tools across 17 providers), with a status widget that makes a running call, its progress and its cost visible in the terminal.",
|
|
7
7
|
"author": {
|
|
8
8
|
"name": "Prowl",
|
|
9
9
|
"email": "support@prowl.chat",
|
|
@@ -14,18 +14,19 @@
|
|
|
14
14
|
"license": "MIT",
|
|
15
15
|
"keywords": [
|
|
16
16
|
"prowl",
|
|
17
|
-
"market-
|
|
18
|
-
"
|
|
17
|
+
"market-data",
|
|
18
|
+
"market-research",
|
|
19
19
|
"seo",
|
|
20
20
|
"ads",
|
|
21
|
+
"trends",
|
|
21
22
|
"mcp"
|
|
22
23
|
],
|
|
23
24
|
"skills": "./skills/",
|
|
24
25
|
"mcpServers": "./.mcp.json",
|
|
25
26
|
"interface": {
|
|
26
27
|
"displayName": "Prowl",
|
|
27
|
-
"shortDescription": "
|
|
28
|
-
"longDescription": "Connect the hosted Prowl MCP server to give any agent
|
|
28
|
+
"shortDescription": "Real-world market data for your agents",
|
|
29
|
+
"longDescription": "Connect the hosted Prowl MCP server to give any agent 444 market data tools across 17 providers – search, ads, SEO, app stores, reviews, social, trends and finance. Each call is billed on its own from one USD wallet, every number comes back with the tool that returned it, and prowl_analyze composes a cross-checked report when one call is not enough. Ships a status widget: an in-flight call and how long it has run, session spend from the server's own billing figures, async-session progress in the dock, and a one-time notice when a call fails or the wallet blocks one.",
|
|
29
30
|
"developerName": "Prowl",
|
|
30
31
|
"category": "Research",
|
|
31
32
|
"capabilities": [
|
|
@@ -37,10 +38,10 @@
|
|
|
37
38
|
"termsOfServiceURL": "https://prowl.chat/terms/",
|
|
38
39
|
"defaultPrompt": [
|
|
39
40
|
"List the Prowl tools available",
|
|
40
|
-
"
|
|
41
|
+
"Pull Google Trends and news for a keyword",
|
|
41
42
|
"Pull SERP and keyword data for a topic"
|
|
42
43
|
],
|
|
43
|
-
"brandColor": "#
|
|
44
|
+
"brandColor": "#3f7d5f",
|
|
44
45
|
"screenshots": []
|
|
45
46
|
}
|
|
46
47
|
}
|
package/plugins/prowl/.mcp.json
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"command": "sh",
|
|
5
5
|
"args": [
|
|
6
6
|
"-lc",
|
|
7
|
-
"TOKEN=\"$(printf %s \"${PROWL_MCP_TOKEN:-}\" | tr -d \"[:space:]\")\"; if [ -z \"$TOKEN\" ] && [ -f \"$HOME/.prowl/prowl_mcp_token\" ]; then TOKEN=\"$(tr -d \"[:space:]\" < \"$HOME/.prowl/prowl_mcp_token\")\"; fi; if [ -z \"$TOKEN\" ] && [ -f \"$HOME/.codex/prowl_mcp_token\" ]; then TOKEN=\"$(tr -d \"[:space:]\" < \"$HOME/.codex/prowl_mcp_token\")\"; fi; if [ -z \"$TOKEN\" ]; then echo 'prowl: no API key; the MCP server will not start.' >&2; echo 'prowl: store one with: npx @prowl-ai/prowl-skill token' >&2; echo 'prowl: or set PROWL_MCP_TOKEN in the environment.' >&2; echo 'prowl: not falling back to OAuth - browser consent cannot finish inside MCP startup.' >&2; exit 78; fi; exec npx -y mcp-remote https://prowl.chat/mcp --header
|
|
7
|
+
"TOKEN=\"$(printf %s \"${PROWL_MCP_TOKEN:-}\" | tr -d \"[:space:]\")\"; if [ -z \"$TOKEN\" ] && [ -f \"$HOME/.prowl/prowl_mcp_token\" ]; then TOKEN=\"$(tr -d \"[:space:]\" < \"$HOME/.prowl/prowl_mcp_token\")\"; fi; if [ -z \"$TOKEN\" ] && [ -f \"$HOME/.codex/prowl_mcp_token\" ]; then TOKEN=\"$(tr -d \"[:space:]\" < \"$HOME/.codex/prowl_mcp_token\")\"; fi; if [ -z \"$TOKEN\" ]; then echo 'prowl: no API key; the MCP server will not start.' >&2; echo 'prowl: store one with: npx @prowl-ai/prowl-skill token' >&2; echo 'prowl: or set PROWL_MCP_TOKEN in the environment.' >&2; echo 'prowl: not falling back to OAuth - browser consent cannot finish inside MCP startup.' >&2; exit 78; fi; PROWL_MCP_AUTH=\"Bearer $TOKEN\"; export PROWL_MCP_AUTH; unset TOKEN; exec npx -y mcp-remote https://prowl.chat/mcp --header 'Authorization:${PROWL_MCP_AUTH}' --transport http-first --silent"
|
|
8
8
|
]
|
|
9
9
|
}
|
|
10
10
|
}
|
|
@@ -1,16 +1,18 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: prowl
|
|
3
|
-
description: Connects this agent to the Prowl MCP
|
|
3
|
+
description: Connects this agent to real-world market data through the Prowl MCP – one endpoint with 444 market data tools across 17 providers (search, ads, SEO, app stores, reviews, social, trends, finance), each call billed on its own from a USD wallet, plus prowl_analyze for a cross-checked report when one call is not enough. Use when a task needs real market data instead of guesses – SERP, keyword, backlink or AI-search data, ad creative or spend, app store listings and reviews, social or trend signals, stock quotes and market news, competitor pricing or funnels, or validating a product idea.
|
|
4
4
|
license: MIT
|
|
5
5
|
compatibility: Requires network access to prowl.chat and a Prowl API token; speaks MCP protocol 2025-06-18 over Streamable HTTP; the bundled MCP config runs `npx mcp-remote` (needs Node.js 18+).
|
|
6
6
|
metadata:
|
|
7
7
|
author: prowl.chat
|
|
8
|
-
version: "0.
|
|
8
|
+
version: "0.5.1"
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
# Prowl
|
|
11
|
+
# Prowl – real-world market data for your agents
|
|
12
12
|
|
|
13
|
-
Prowl is a single MCP endpoint that exposes **
|
|
13
|
+
Prowl is a single MCP endpoint that exposes **444 market data tools** across 17 providers (DataForSEO, SearchAPI, SerpApi, Moz, SpyFu, Majestic, Keywords Everywhere, Foreplay, Firecrawl, Exa, Perplexity, Gemini, …): search, ads, SEO, app stores, reviews, social, trends and finance. The agent calls what it needs, each call is billed on its own from one USD wallet, and every number comes back with the tool that returned it.
|
|
14
|
+
|
|
15
|
+
One call for one number; a report when one call is not enough. `prowl_analyze` plans many calls, cross-checks numeric claims against independent tools and composes a report (up to 16 intelligence modules, 8 without a subscription). Async sessions, recurring schedules, artifacts and exports build on it. People without an agent of their own use Prowl Agent on [prowl.chat](https://prowl.chat), which runs on the same tools.
|
|
14
16
|
|
|
15
17
|
Prefer the sibling `prowl-cli` skill when the work belongs in a shell script or a CI job; use this one when the agent should call Prowl as MCP tools inside its own tool loop.
|
|
16
18
|
|
|
@@ -22,7 +24,7 @@ Prefer the sibling `prowl-cli` skill when the work belongs in a shell script or
|
|
|
22
24
|
|
|
23
25
|
Prowl API keys (`prowl_...`) are billing-bearing — every metered call debits a USD wallet. Treat the key as a secret; never commit it to a public repo.
|
|
24
26
|
|
|
25
|
-
1. The human signs up at [https://prowl.chat](https://prowl.chat) (gets $
|
|
27
|
+
1. The human signs up at [https://prowl.chat](https://prowl.chat) (gets $15 starter credit, no card), optionally tops up the wallet, and generates a `prowl_...` key (shown once) under **MCP Home → API keys & config**.
|
|
26
28
|
2. Provide the key to this plugin via either:
|
|
27
29
|
- environment variable `PROWL_MCP_TOKEN`, or
|
|
28
30
|
- a token file at `~/.prowl/prowl_mcp_token` (`mkdir -p ~/.prowl && printf '%s' "prowl_YOUR_KEY" > ~/.prowl/prowl_mcp_token && chmod 600 ~/.prowl/prowl_mcp_token`).
|
|
@@ -42,7 +44,7 @@ For manual per-client setup (Cursor `.cursor/mcp.json`, Claude Code `claude mcp
|
|
|
42
44
|
| `prowl_search_tools` | Semantic search over the catalog | free |
|
|
43
45
|
| `prowl_tool_info` | JSON input schema + estimated cost for one tool | free |
|
|
44
46
|
| `prowl_call_tool` | Invoke any single tool | metered |
|
|
45
|
-
| `prowl_analyze` |
|
|
47
|
+
| `prowl_analyze` | A report when one call is not enough: plans the calls, cross-checks numeric claims, composes the modules | metered, sized by `execution_mode` |
|
|
46
48
|
| `prowl_get_wallet` | Balance, and which `execution_mode`s this key can really run | free |
|
|
47
49
|
| `prowl_list_playbooks` | The 8 fixed, persona-tuned report shapes | free |
|
|
48
50
|
| `prowl_start_session` / `prowl_session_status` / `prowl_get_session` / `prowl_list_sessions` | Async deep research: kick off, poll, read back | metered |
|
|
@@ -57,7 +59,7 @@ costs about 4k tokens and is returned only for `names=true` or a single
|
|
|
57
59
|
`category`. Reach for `prowl_search_tools` to find a tool by intent; it is the
|
|
58
60
|
cheap path and ranks by relevance.
|
|
59
61
|
|
|
60
|
-
Recommended flow: `prowl_search_tools` → `prowl_tool_info` → `prowl_call_tool` for one
|
|
62
|
+
Recommended flow: `prowl_search_tools` → `prowl_tool_info` → `prowl_call_tool` for one number; `prowl_analyze` when the task needs a report rather than one call. Pass a stable `session_id` across calls to keep the report cache and conversation memory scoped to one conversation — `prowl_generate_artifact` and `prowl_export_report` read the report cached against that session, so they need a prior `prowl_analyze` on the same id.
|
|
61
63
|
|
|
62
64
|
Full reference: [https://prowl.chat/mcp/skill.md](https://prowl.chat/mcp/skill.md)
|
|
63
65
|
|
|
@@ -83,7 +85,7 @@ had not.
|
|
|
83
85
|
| `execution_mode` | Use for | Calls per run | Time | Requires |
|
|
84
86
|
|------|---------|--------------:|------|----------|
|
|
85
87
|
| `basic` | One question, fast turnaround | 20–100 | 30–90s | — |
|
|
86
|
-
| `deep` | Full
|
|
88
|
+
| `deep` | Full report, evidence-verified | 40–300 | 3–5 min | Exploit+ subscription |
|
|
87
89
|
| `max` | Exhaustive, claims adversarially checked | 60–400 | 5–10 min | Blackops+ subscription |
|
|
88
90
|
|
|
89
91
|
**A key without the subscription is not refused — it is downgraded.** `deep` and
|
|
@@ -104,7 +106,7 @@ Call `prowl_list_playbooks` (free) for what each one covers.
|
|
|
104
106
|
## Verify
|
|
105
107
|
|
|
106
108
|
1. List MCP tools; confirm `prowl_list_tools`, `prowl_tool_info`, `prowl_call_tool`, `prowl_analyze`.
|
|
107
|
-
2. Run `prowl_list_tools` (free) → category counts summing to `total_tools:
|
|
109
|
+
2. Run `prowl_list_tools` (free) → category counts summing to `total_tools: 444`. (It returns counts, not names — pass `names=true` for the full list.)
|
|
108
110
|
3. Run `prowl_get_wallet` (free) → the key is valid, and the balance and available modes come back.
|
|
109
111
|
4. Connectivity check (no auth): `curl https://prowl.chat/mcp/health`. It answers
|
|
110
112
|
`status`, `server`, `version`, `transport` and `endpoint` — and nothing else, so
|
|
@@ -187,7 +189,7 @@ is a place an attacker can write.
|
|
|
187
189
|
|
|
188
190
|
## When to use
|
|
189
191
|
|
|
190
|
-
|
|
192
|
+
Any task that needs real market data: market research and analytics, marketing and ads (creative and spend), SEO and AI search (SERP, keywords, backlinks, GEO/AEO visibility), social media, creative research, trends, investing context (stock quotes, market movers, ticker search, news and search interest – data, never advice), product development and idea validation, e-commerce, local businesses and reviews, competitor pricing and funnels.
|
|
191
193
|
|
|
192
194
|
## When not to use
|
|
193
195
|
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
|
|
3
3
|
"name": "prowl-cli",
|
|
4
4
|
"displayName": "Prowl CLI",
|
|
5
|
-
"description": "Prowl CLI skill: drive the
|
|
6
|
-
"version": "0.
|
|
5
|
+
"description": "Prowl CLI skill: real-world market data from the shell – drive the 444-tool Prowl market data catalog with @prowl-ai/cli, no MCP server required.",
|
|
6
|
+
"version": "0.3.0",
|
|
7
7
|
"author": {
|
|
8
8
|
"name": "Prowl",
|
|
9
9
|
"email": "support@prowl.chat",
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
|
|
3
3
|
"name": "prowl-cli",
|
|
4
4
|
"displayName": "Prowl CLI",
|
|
5
|
-
"version": "0.
|
|
6
|
-
"description": "Prowl CLI skill: drive the
|
|
5
|
+
"version": "0.3.0",
|
|
6
|
+
"description": "Prowl CLI skill: real-world market data from the shell – drive the 444-tool Prowl market data catalog with @prowl-ai/cli, no MCP server required.",
|
|
7
7
|
"author": {
|
|
8
8
|
"name": "Prowl",
|
|
9
9
|
"email": "support@prowl.chat",
|
|
@@ -15,8 +15,8 @@
|
|
|
15
15
|
"keywords": [
|
|
16
16
|
"prowl",
|
|
17
17
|
"cli",
|
|
18
|
-
"market-
|
|
19
|
-
"
|
|
18
|
+
"market-data",
|
|
19
|
+
"market-research",
|
|
20
20
|
"seo",
|
|
21
21
|
"serp",
|
|
22
22
|
"ads"
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
"skills": "./skills/",
|
|
25
25
|
"interface": {
|
|
26
26
|
"displayName": "Prowl CLI",
|
|
27
|
-
"shortDescription": "
|
|
27
|
+
"shortDescription": "444 market data tools from the shell",
|
|
28
28
|
"longDescription": "Teaches the agent the Prowl command-line client (@prowl-ai/cli): install and key handling, the free catalog commands, metered tool calls, analyze tiers with hard cost caps, playbooks, JSON output and exit codes. Useful wherever a shell is available and no MCP server is configured.",
|
|
29
29
|
"developerName": "Prowl",
|
|
30
30
|
"category": "Research",
|
|
@@ -37,10 +37,10 @@
|
|
|
37
37
|
"termsOfServiceURL": "https://prowl.chat/terms/",
|
|
38
38
|
"defaultPrompt": [
|
|
39
39
|
"Search the Prowl tool catalog for backlink tools",
|
|
40
|
-
"
|
|
40
|
+
"Pull Google Trends for a keyword from the shell",
|
|
41
41
|
"Check my Prowl wallet balance"
|
|
42
42
|
],
|
|
43
|
-
"brandColor": "#
|
|
43
|
+
"brandColor": "#3f7d5f",
|
|
44
44
|
"screenshots": []
|
|
45
45
|
}
|
|
46
46
|
}
|
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: prowl-cli
|
|
3
|
-
description: Drives the Prowl CLI (`@prowl-ai/cli`)
|
|
3
|
+
description: Drives the Prowl CLI (`@prowl-ai/cli`) – a shell client for real-world market data, exposing 444 market data tools across 17 providers (search with 102 SearchAPI engines, ads, SEO and backlinks, app stores, reviews, social, trends, finance) plus `prowl analyze` for a report when one call is not enough, each call billed from a USD wallet. Use when a shell is available and market data is needed in a script, a CI job or a one-off command – SERP and keyword data, backlink profiles, ad creative research, trends, stock quotes and news, competitor pricing and demand validation – without configuring an MCP server.
|
|
4
4
|
license: MIT
|
|
5
5
|
compatibility: Requires Node.js 18+, the `@prowl-ai/cli` npm package (installed globally or run via npx) and a Prowl API key; speaks MCP protocol 2025-06-18 to prowl.chat over the network.
|
|
6
6
|
metadata:
|
|
7
7
|
author: prowl.chat
|
|
8
|
-
version: "0.
|
|
8
|
+
version: "0.3.0"
|
|
9
9
|
# The @prowl-ai/cli release this page describes. NOT the plugin version above:
|
|
10
10
|
# they are different things that happened to both read 0.2.x, and nothing
|
|
11
11
|
# compared them until scripts/check-cli.js did.
|
|
12
|
-
documents_cli: "0.
|
|
12
|
+
documents_cli: "0.3.0"
|
|
13
13
|
---
|
|
14
14
|
|
|
15
|
-
# Prowl CLI
|
|
15
|
+
# Prowl CLI – real-world market data from the shell
|
|
16
16
|
|
|
17
|
-
`@prowl-ai/cli` is the command-line client for [Prowl](https://prowl.chat): one binary that reaches **
|
|
17
|
+
`@prowl-ai/cli` is the command-line client for [Prowl](https://prowl.chat): one binary that reaches **444 market data tools** across 17 providers – search, ads, SEO, app stores, reviews, social, trends and finance – plus `analyze`, which plans many calls and composes a cross-checked report when one call is not enough. Every metered call debits a USD wallet, and every number comes back with the tool that returned it.
|
|
18
18
|
|
|
19
19
|
Use this skill when a shell is available. Use the sibling `prowl` plugin instead when the agent should call Prowl as MCP tools inside its own tool loop.
|
|
20
20
|
|
|
@@ -26,7 +26,7 @@ Prowl API keys (`prowl_...`) are **billing-bearing** — treat them as secrets a
|
|
|
26
26
|
npm install -g @prowl-ai/cli
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
**This page documents CLI `0.
|
|
29
|
+
**This page documents CLI `0.3.0`**, which is what npm serves as `latest`. On `0.1.1` or
|
|
30
30
|
older only `auth`, `tools`, `call`, `analyze`, `wallet` and `version` exist and
|
|
31
31
|
everything else answers `Unknown command` — `prowl version` says which you have.
|
|
32
32
|
|
|
@@ -93,7 +93,7 @@ redirect the report instead: `prowl session get <id> > report.md`.
|
|
|
93
93
|
Global flags: `--json` (one machine-readable JSON document on stdout — always use this when parsing), `--key <k>`, `--quiet`, `-h`.
|
|
94
94
|
Environment: `PROWL_API_KEY`, `PROWL_BASE_URL`, `PROWL_MCP_URL`, `PROWL_TIMEOUT_MS`.
|
|
95
95
|
|
|
96
|
-
Recommended flow: `tools search` → `tools info` (check the cost) → `call`. Reach for `analyze` when the goal is a
|
|
96
|
+
Recommended flow: `tools search` → `tools info` (check the cost) → `call`. Reach for `analyze` when one call is not enough and the goal is a report rather than one number. Pass a stable `--session <id>` across consecutive calls to keep the report cache, history and spend scoped to one investigation; `artifact` and `export` read the report cached against that session, so they need a prior `analyze` on the same id.
|
|
97
97
|
|
|
98
98
|
`tools list` returns category **counts**, not names — pass `--names` or `--category <c>` for names, or prefer `tools search`, which is cheaper and ranks by relevance.
|
|
99
99
|
|
|
@@ -104,14 +104,15 @@ Recommended flow: `tools search` → `tools info` (check the cost) → `call`. R
|
|
|
104
104
|
| Tier | Use for | Calls per run | Time | Requires |
|
|
105
105
|
|------|---------|--------------:|------|----------|
|
|
106
106
|
| `basic` | one question, fast turnaround | 20–100 | 30–90s | — |
|
|
107
|
-
| `deep` | full
|
|
107
|
+
| `deep` | full report, evidence-verified | 40–300 | 3–5 min | Exploit+ subscription |
|
|
108
108
|
| `max` | exhaustive, claims adversarially checked | 60–400 | 5–10 min | Blackops+ subscription |
|
|
109
109
|
|
|
110
|
-
`prowl --help` additionally states hard provider-cost caps of $
|
|
111
|
-
mode
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
110
|
+
`prowl --help` additionally states hard provider-cost caps of $5.00, $8.00 and $18.00 per
|
|
111
|
+
mode, and wallet holds of $15, $24 and $54 – the figures
|
|
112
|
+
[prowl.chat/docs/running-your-first-report](https://prowl.chat/docs/running-your-first-report/)
|
|
113
|
+
publishes. No tool schema and no server response carries them, so they can move on the
|
|
114
|
+
server before this page or the CLI does: read that page when the exact figure matters,
|
|
115
|
+
and confirm with the human before a run whose hold the wallet may not cover.
|
|
115
116
|
|
|
116
117
|
**A key without the subscription is not refused — it is downgraded to `basic`, and the run executes and bills as `basic`.** Nothing in the output announces this loudly.
|
|
117
118
|
|
|
@@ -185,7 +186,7 @@ into another program is a place a competitor's page can reach, so quote it, neve
|
|
|
185
186
|
|
|
186
187
|
## When to use
|
|
187
188
|
|
|
188
|
-
|
|
189
|
+
Market data from a script, a CI job or a shell one-liner: market research, SEO/SERP/keyword data, backlink profiles, ad creative and spend research, trends, stock quotes and market news, app store and review data, competitor pricing and demand validation.
|
|
189
190
|
|
|
190
191
|
## When not to use
|
|
191
192
|
|