@datadive-tools/mcp 0.16.0 → 0.17.0

package/README.md

@@ -103,12 +103,17 @@ niches, plus pagination metadata. If you don't, see Troubleshooting below.
 | `get_niche_competitors` | Competitor ASINs, titles, BSR, category and niche statistics (sales, revenue, ratings, opportunity score). |
 | `get_ranking_juice` | DataDive proprietary ranking-juice metric per competitor (current vs optimized listing). |
 | `list_rank_radars` | Paginated list of rank radars. Filter by `nicheId`, `searchText` or `status` (`ACTIVE` by default, plus `PAUSED`, `ARCHIVED`, `ALL`). |
-| `get_rank_radar_data` | Historical keyword rankings for a rank radar within a `startDate`/`endDate` range (max 90 days). Paged by keyword: walk `currentPage` while `hasNext` is true, `pageSize` up to 100. |
+| `get_rank_radar_data` | Historical keyword rankings for a rank radar within a `startDate`/`endDate` range (max 90 days). Returns every active keyword by default; pass `currentPage`/`pageSize` (up to 100) to read one page at a time. |
 | `get_rank_radar_sqp_data` | Amazon Search Query Performance per Rank Radar keyword: search volume, impressions, clicks, cart adds, purchases — market total vs this ASIN family. Same date range and paging as `get_rank_radar_data`. |
 | `get_rank_radar_ppc_data` | Sponsored Products metrics per Rank Radar keyword: sponsored rank, spend, sales, ACOS, CPC, match types; optional per-campaign breakdown. Same date range and paging as `get_rank_radar_data`. |
 | `create_niche_dive` | **Spends dive tokens.** Starts new niche research from a seed ASIN. Async — returns a `diveId` to poll with `get_dive_status`. Requires `confirm: true`. |
 | `create_niche_dive_from_competitors_list` | **Spends dive tokens.** Starts niche research from your own list of 2–200 competitor ASINs, with no automatic discovery. Async — returns a `diveId` to poll with `get_dive_status`. Requires `confirm: true`. |
 | `redive_niche` | **Spends dive tokens.** Refreshes an existing niche with current data — either the same competitors or a newly discovered set. Async — returns a `diveId` to poll with `get_dive_status`. Requires `confirm: true`. |
+| `add_niche_keywords` | Adds keywords to a niche's Master Keyword List (1–100 per call). Free on a niche dived in the last 24 hours. **On an older niche it re-dives the niche and spends dive tokens** — then it asks for `confirm: true` first. |
+| `remove_niche_keywords` | Takes keywords back out of a niche's Master Keyword List: hand-added ones are deleted, ones from Outliers/Residue go back there, dive-found ones stay. Free. |
+| `list_keyword_exclusions` | The keywords a niche hides from its Master Keyword List: exact entries with their search volume, phrase entries with how many keywords and how much search volume they hide. |
+| `add_keyword_exclusions` | Hides keywords from a niche's Master Keyword List — `exact` (one keyword) or `phrase` (every keyword containing it), 1–100 entries per call. Free; undone by `remove_keyword_exclusions`. |
+| `remove_keyword_exclusions` | Removes exact or phrase exclusions so the keywords they hid show again. Free. |
 | `get_dive_status` | Poll a dive started by `create_niche_dive` or `redive_niche`: `in_progress`, `success` (carries the `nicheId`), or `error`. |
 | `create_rank_radar` | **Spends Search Term tokens.** Starts tracking keyword rankings for an ASIN in a niche. Returns a `rankRadarId`. Requires `confirm: true`. |
 | `add_rank_radar_search_terms` | Starts tracking extra keywords on an existing rank radar. Takes one Daily Tracked Keywords slot per new keyword; reversible with `pause_rank_radar_search_terms`. |
@@ -163,6 +168,12 @@ The other write tools — `pause_rank_radar`, `resume_rank_radar` and the three
 Tracked Keywords capacity, which is freed again when you pause, and each is
 undone by its counterpart.
 
+`add_niche_keywords` asks for `confirm: true` only when it would spend: on a
+niche dived in the last 24 hours its first call adds the keywords for free, while
+on an older niche that call changes nothing and returns the Dive token cost of the
+re-dive the add triggers. `remove_niche_keywords` and the keyword exclusion
+tools are free and need no confirmation.
+
 To skip the per-call confirmation (e.g. in an automated setup), set
 `DATADIVE_AUTO_CONFIRM_WRITES=true` in your client config — then all six run
 without `confirm`, deletes included.