@datadive-tools/mcp 0.16.1 → 0.18.0

package/README.md

@@ -109,6 +109,11 @@ niches, plus pagination metadata. If you don't, see Troubleshooting below.
 | `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`. |
@@ -124,7 +129,7 @@ niches, plus pagination metadata. If you don't, see Troubleshooting below.
 | `get_seller_catalog` | Paginated catalog of a seller's own ASINs. Filter by `search`, `brand`, and `status` (Active by default). |
 | `get_seller_listing_changes` | Paginated price/content/image changes on a seller's listings. Filter by `types`, `asin`, `brand`, `search`, and a date range; optionally include ranking/conversion `correlation`. |
 | `list_ppc_campaigns` | Sponsored Products campaigns of a seller account with window totals and a per-placement breakdown. Filter by `asin` / `parentAsin`, `state`, `search`; sort by any metric. Window up to 90 days (default 30). |
-| `get_asin_inventory_distribution` | Per-fulfillment-center sellable inventory for an ASIN. Requires `sellerId` from `list_seller_profiles` or your Connections page. |
+| `get_asin_inventory_distribution` | Inventory metrics for an ASIN (stock, days of stock, low-inventory state, LILF and LTSF fees, aged units) and its per-fulfillment-center sellable inventory. Requires `sellerId` from `list_seller_profiles` or your Connections page. |
 | `list_indexing_issue_alerts` | Paginated list of indexing-issue alerts — ASINs no longer indexed for their tracked keywords. Filter by `sellerId`, `marketplace`, `status`, or `updatedSince`. |
 | `list_blind_spend_alerts` | Paginated list of blind-spend alerts — ad spend on search terms with little or no sales, with per-term spend/clicks/CVR. Same filters as above. |
 | `get_quota` | Current quota usage and capacity per billable feature, plus the next refresh date. No arguments. |
@@ -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.