mastra-scavio 0.7.2 → 0.8.0

package/README.md

@@ -1,8 +1,8 @@
 # mastra-scavio
 
-[Scavio](https://scavio.dev) real-time data tools for [Mastra](https://mastra.ai) agents — **188 tools across 31 platforms** on one API key. Retail (Amazon, Walmart, eBay, Target, Home Depot), real estate (Zillow, Redfin), travel (Booking.com, Airbnb, Tripadvisor), local (Yelp, Google Maps), jobs (Indeed, Glassdoor, LinkedIn), software reviews (G2, Capterra), app stores (App Store, Google Play), company filings (SEC EDGAR, Companies House), ad libraries (Google Ads Transparency, Meta Ad Library), search (Google) and social (YouTube, TikTok, Instagram, X, Reddit, Threads, Kuaishou) — plus `scavioExtract`, which reads any URL as clean Markdown, and five opt-in tools that map a site's URLs, crawl a whole site or batch-extract a URL list.
+[Scavio](https://scavio.dev) real-time data tools for [Mastra](https://mastra.ai) agents — **189 tools across 31 platforms** on one API key. Retail (Amazon, Walmart, eBay, Target, Home Depot), real estate (Zillow, Redfin), travel (Booking.com, Airbnb, Tripadvisor), local (Yelp, Google Maps), jobs (Indeed, Glassdoor, LinkedIn), software reviews (G2, Capterra), app stores (App Store, Google Play), company filings (SEC EDGAR, Companies House), ad libraries (Google Ads Transparency, Meta Ad Library), search (Google) and social (YouTube, TikTok, Instagram, X, Reddit, Threads, Kuaishou) — plus `scavioExtract`, which reads any URL as clean Markdown, and five opt-in tools that map a site's URLs, crawl a whole site or batch-extract a URL list.
 
-> **Amazon changed (breaking).** The upstream provider moved in 2026-07:
+> **Amazon changed (breaking).** The Amazon endpoint changed in 2026-07:
 > `domain` is replaced by `country`, a two-letter marketplace code (`us`, `gb`
 > -- the UK is `gb`, not `uk` -- `de`, `jp`, ...), and `sort_by`, `pages`,
 > `category_id`, `merchant_id`, `language`, `currency`, `device`, `zip_code`
@@ -53,7 +53,7 @@ const agent = new Agent({
 
 ## Tools
 
-`createScavioTools()` returns **188 tools** across 31 platforms plus `extract` — one per billable Scavio endpoint — and **193** with `{ enableCrawl: true }`, which adds the five website tools. Requires `scavio@^0.23.0`.
+`createScavioTools()` returns **189 tools** across 31 platforms plus `extract` — one per billable Scavio endpoint — and **194** with `{ enableCrawl: true }`, which adds the five website tools. Requires `scavio@^0.27.0`.
 
 | Platform | Tools | Names |
 |---|---|---|
@@ -72,7 +72,7 @@ const agent = new Agent({
 | [Threads](https://scavio.dev/docs/threads-profile) | 6 | `scavioThreadsProfile`, `scavioThreadsUserPosts`, `scavioThreadsUserReplies`, `scavioThreadsPost`, `scavioThreadsPostComments`, `scavioThreadsSearchUsers` |
 | [Kuaishou](https://scavio.dev/docs/kuaishou-profile) | 14 | `scavioKuaishouProfile`, `scavioKuaishouUserPosts`, `scavioKuaishouUserLive`, `scavioKuaishouUserResolve`, `scavioKuaishouVideo`, `scavioKuaishouVideoComments`, `scavioKuaishouCommentReplies`, `scavioKuaishouVideosBatch`, `scavioKuaishouSearch`, `scavioKuaishouSearchVideos`, `scavioKuaishouSearchUsers`, `scavioKuaishouSearchLive`, `scavioKuaishouTagFeed`, `scavioKuaishouTrending` |
 | [eBay](https://scavio.dev/docs/ebay-search) | 3 | `scavioEbaySearch`, `scavioEbayProduct`, `scavioEbaySeller` |
-| [Target](https://scavio.dev/docs/target-search) | 4 | `scavioTargetSearch`, `scavioTargetCategory`, `scavioTargetProduct`, `scavioTargetReviews` |
+| [Target](https://scavio.dev/docs/target-search) | 5 | `scavioTargetSearch`, `scavioTargetCategory`, `scavioTargetProduct`, `scavioTargetReviews`, `scavioTargetAvailability` |
 | [Home Depot](https://scavio.dev/docs/home-depot-search) | 3 | `scavioHomeDepotSearch`, `scavioHomeDepotProduct`, `scavioHomeDepotReviews` |
 | [Zillow](https://scavio.dev/docs/zillow-search) | 3 | `scavioZillowSearch`, `scavioZillowProperty`, `scavioZillowAgentReviews` |
 | [Booking.com](https://scavio.dev/docs/booking-search) | 3 | `scavioBookingSearch`, `scavioBookingHotel`, `scavioBookingReviews` |
@@ -119,7 +119,7 @@ Reddit, TikTok and Instagram shipped two tools each before 0.5.0; the rest of th
 
 ### New in 0.7.0
 
-Five website tools, opt-in with `createScavioTools({ enableCrawl: true })` so the default set is unchanged: `scavioMapWebsite`, `scavioCrawlWebsite`, `scavioCrawlStatus`, `scavioBatchExtract` and `scavioBatchStatus`. Requires `scavio@^0.23.0`, whose `extract` became a callable namespace (`scavio.extract({ url })` still reads one page). See [Map, crawl and batch](#map-crawl-and-batch).
+Five website tools, opt-in with `createScavioTools({ enableCrawl: true })` so the default set is unchanged: `scavioMapWebsite`, `scavioCrawlWebsite`, `scavioCrawlStatus`, `scavioBatchExtract` and `scavioBatchStatus`. Requires `scavio@^0.27.0`, whose `extract` became a callable namespace (`scavio.extract({ url })` still reads one page). See [Map, crawl and batch](#map-crawl-and-batch).
 
 ### New in 0.6.0
 
@@ -216,7 +216,7 @@ No single number is true for these, so each tool states its own price and none o
 | Surface | Price |
 |---|---|
 | `scavioWalmartSearch`, `scavioWalmartCategory` | 1 credit on `domain` `com` or `ca`, **2 on `com.mx`**. The other five Walmart tools take no `domain` and are always 1. |
-| `scavioThreadsProfile`, `scavioThreadsUserPosts`, `scavioThreadsUserReplies` | **2 credits addressed by `user_id`, 4 by `username`** — a handle buys a second upstream call, because the upstream handle lookup is dead. Pass `user_id` whenever you have it. The other three Threads tools have no username form and are always 2. |
+| `scavioThreadsProfile`, `scavioThreadsUserPosts`, `scavioThreadsUserReplies` | **2 credits addressed by `user_id`, 4 by `username`** — a handle buys a second lookup. Pass `user_id` whenever you have it. The other three Threads tools have no username form and are always 2. |
 | Kuaishou | **Per endpoint, 1 to 40.** See the table above; one platform-wide figure would be wrong by up to 40x. |
 | `scavioExtract` | 1 credit on `mode` `normal` or `advanced`, **2 on `ultra`**. Only a successful extraction is billed — a dead link, bot wall or timeout costs nothing. |
 | `scavioMapWebsite` | 1 credit on `mode` `normal`; up to 2 on `advanced`, up to 10 on `ultra`, priced by what the call needed. |

package/dist/index.cjs

@@ -147,6 +147,7 @@ __export(index_exports, {
   createScavioSecFilingsTool: () => createScavioSecFilingsTool,
   createScavioSecLookupTool: () => createScavioSecLookupTool,
   createScavioSecSearchTool: () => createScavioSecSearchTool,
+  createScavioTargetAvailabilityTool: () => createScavioTargetAvailabilityTool,
   createScavioTargetCategoryTool: () => createScavioTargetCategoryTool,
   createScavioTargetProductTool: () => createScavioTargetProductTool,
   createScavioTargetReviewsTool: () => createScavioTargetReviewsTool,
@@ -2544,7 +2545,7 @@ var ebayToolSpecs = [
         "price_low",
         "price_high"
       ]).optional().describe(
-        "Result sort order. Defaults to 'best_match'. eBay's 'Distance: nearest first' is deliberately unsupported (it ranks against our proxy exit, not the caller)."
+        "Result sort order. Defaults to 'best_match'. eBay's 'Distance: nearest first' is deliberately unsupported (it would not rank by the location of the caller)."
       ),
       min_price: import_zod15.z.number().optional().describe("Minimum price, inclusive. Must be 0 or greater."),
       max_price: import_zod15.z.number().optional().describe("Maximum price, inclusive. Must be 0 or greater."),
@@ -2628,7 +2629,7 @@ var targetToolSpecs = [
         "Result sort order. Defaults to 'relevance'."
       ),
       store_id: import_zod16.z.string().optional().describe(
-        "Numeric Target store id whose prices and availability the response reflects. Defaults to '3991', the store target.com uses with no store context."
+        "Numeric Target store id whose prices the response reflects. Defaults to '3991', the store target.com uses with no store context."
       )
     }),
     call: (client, input) => client.target.search(input)
@@ -2660,7 +2661,7 @@ var targetToolSpecs = [
         "Result sort order. Defaults to 'relevance'."
       ),
       store_id: import_zod16.z.string().optional().describe(
-        "Numeric Target store id whose prices and availability the response reflects. Defaults to '3991'."
+        "Numeric Target store id whose prices the response reflects. Defaults to '3991'."
       )
     }),
     call: (client, input) => client.target.category(input)
@@ -2677,7 +2678,7 @@ var targetToolSpecs = [
         "Target catalog id (tcin, e.g. '1010453160'). A colour/size child tcin is answered by its variation parent, with the child present in 'variants'."
       ),
       store_id: import_zod16.z.string().optional().describe(
-        "Numeric Target store id whose prices and availability the response reflects. Defaults to '3991'."
+        "Numeric Target store id whose prices the response reflects. Defaults to '3991'."
       )
     }),
     call: (client, input) => client.target.product(input)
@@ -2695,16 +2696,32 @@ var targetToolSpecs = [
         "Trim the returned reviews to at most this many (1 or greater). Target publishes 8 anonymously and offers no paging, so this only trims."
       ),
       store_id: import_zod16.z.string().optional().describe(
-        "Numeric Target store id whose prices and availability the response reflects. Defaults to '3991'."
+        "Numeric Target store id whose prices the response reflects. Defaults to '3991'."
       )
     }),
     call: (client, input) => client.target.reviews(input)
+  }),
+  defineScavioTool({
+    key: "scavioTargetAvailability",
+    id: "scavio-target-availability",
+    platform: "target",
+    endpoint: "/api/v1/target/availability",
+    credits: 1,
+    description: "In-store stock for a Target product at every store near a ZIP: units available, in-store, pickup, curbside and ship-to-store status, distance, address and hours. Costs 1 credit.",
+    inputSchema: import_zod16.z.object({
+      tcin: import_zod16.z.string().describe("Target catalog id (tcin, e.g. '85978609')."),
+      zip: import_zod16.z.string().describe("5-digit US ZIP code to search around."),
+      radius: import_zod16.z.number().int().optional().describe("Search radius in miles, 1-100. Defaults to 25. At most 20 stores."),
+      store_id: import_zod16.z.string().optional().describe("Return only this Target store. It must be within radius of zip.")
+    }),
+    call: (client, input) => client.target.availability(input)
   })
 ];
 var createScavioTargetSearchTool = toolFactory(targetToolSpecs, "scavioTargetSearch");
 var createScavioTargetCategoryTool = toolFactory(targetToolSpecs, "scavioTargetCategory");
 var createScavioTargetProductTool = toolFactory(targetToolSpecs, "scavioTargetProduct");
 var createScavioTargetReviewsTool = toolFactory(targetToolSpecs, "scavioTargetReviews");
+var createScavioTargetAvailabilityTool = toolFactory(targetToolSpecs, "scavioTargetAvailability");
 
 // src/home-depot.ts
 var import_zod17 = require("zod");
@@ -2994,7 +3011,7 @@ var bookingToolSpecs = [
       ),
       rooms: import_zod19.z.number().int().optional().describe("Rooms required, >= 1 (default 1)."),
       currency: import_zod19.z.string().optional().describe(
-        "ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking prices off the proxy exit and identical requests disagree."
+        "ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking picks a currency itself and identical requests can disagree."
       )
     }),
     call: (client, input) => client.booking.search(input)
@@ -3025,7 +3042,7 @@ var bookingToolSpecs = [
       ),
       rooms: import_zod19.z.number().int().optional().describe("Rooms required, >= 1 (default 1)."),
       currency: import_zod19.z.string().optional().describe(
-        "ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking prices off the proxy exit and identical requests disagree."
+        "ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking picks a currency itself and identical requests can disagree."
       )
     }),
     call: (client, input) => client.booking.hotel(input)
@@ -3315,7 +3332,7 @@ var airbnbToolSpecs = [
         "Comma-separated amenities (1-200 characters): wifi, air_conditioning, pool, kitchen, free_parking, washer, self_check_in, tv, or raw numeric Airbnb amenity ids. An unrecognised NAME is rejected before the scrape."
       ),
       currency: import_zod22.z.string().optional().describe(
-        "ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Airbnb prices off the proxy exit and identical requests disagree."
+        "ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Airbnb picks a currency itself and identical requests can disagree."
       ),
       page: import_zod22.z.number().int().optional().describe(
         "Results page, 1-based. 18 listings per page. Cannot be combined with cursor."
@@ -3421,7 +3438,7 @@ var glassdoorToolSpecs = [
     description: "Up to THREE full Glassdoor reviews - the cap is Glassdoor's login wall - with per-axis scores, pros, cons, advice, job title, location, employment status and employer response, plus complete rating statistics, star distribution, aggregate pro/con highlight terms and per-job-title review counts. There is no page param: move the window with category and employment_status. Provide employer_id or url. Costs 1 credit.",
     inputSchema: import_zod23.z.object({
       employer_id: import_zod23.z.string().optional().describe(
-        "Glassdoor employer id (1-50 characters): '1699', 'E1699' or 'IE1699'. Must be a STRING - a JSON number is rejected. Addressing by id costs two upstream fetches; the customer price is unchanged."
+        "Glassdoor employer id (1-50 characters): '1699', 'E1699' or 'IE1699'. Must be a STRING - a JSON number is rejected. Addressing by id takes an extra lookup; the customer price is unchanged."
       ),
       company: import_zod23.z.string().optional().describe(
         "Employer name as it appears in a Glassdoor slug (1-200 characters). COSMETIC: ignored when url is set, and it does not satisfy the employer_id-or-url requirement."
@@ -3454,7 +3471,7 @@ var glassdoorToolSpecs = [
     description: "Glassdoor salaries by job title, 10 titles per page: base-pay and total-pay percentiles P10-P90 with medians called out, sample counts, currency, pay period and last-reported date. The figures are Glassdoor's ESTIMATES for the title, not individual reported salaries. Provide employer_id or url. Costs 1 credit.",
     inputSchema: import_zod23.z.object({
       employer_id: import_zod23.z.string().optional().describe(
-        "Glassdoor employer id (1-50 characters): '1699', 'E1699' or 'IE1699'. Must be a STRING - a JSON number is rejected. Addressing by id costs two upstream fetches; the customer price is unchanged."
+        "Glassdoor employer id (1-50 characters): '1699', 'E1699' or 'IE1699'. Must be a STRING - a JSON number is rejected. Addressing by id takes an extra lookup; the customer price is unchanged."
       ),
       company: import_zod23.z.string().optional().describe(
         "Employer name as it appears in a Glassdoor slug (1-200 characters). COSMETIC: ignored when url is set, and it does not satisfy the employer_id-or-url requirement."
@@ -3501,7 +3518,7 @@ var yelpToolSpecs = [
         "What to look for (1-200 characters): a category ('plumbers'), a dish, or a business name. Required together with location unless url is given."
       ),
       location: import_zod24.z.string().optional().describe(
-        "Where to look (1-200 characters): city and region, a full address, or a postcode. Effectively required - Yelp geolocates a location-less search off the proxy exit, so the same request answers about a different metro run to run."
+        "Where to look (1-200 characters): city and region, a full address, or a postcode. Effectively required - without it Yelp picks a location itself, so the same request can answer about a different metro run to run."
       ),
       page: import_zod24.z.number().int().optional().describe(
         "Results page, 1-based. Yelp fixes the page size at 10."
@@ -4793,6 +4810,7 @@ function createScavioTools(config) {
     scavioTargetCategory: createScavioTargetCategoryTool(config),
     scavioTargetProduct: createScavioTargetProductTool(config),
     scavioTargetReviews: createScavioTargetReviewsTool(config),
+    scavioTargetAvailability: createScavioTargetAvailabilityTool(config),
     scavioHomeDepotSearch: createScavioHomeDepotSearchTool(config),
     scavioHomeDepotProduct: createScavioHomeDepotProductTool(config),
     scavioHomeDepotReviews: createScavioHomeDepotReviewsTool(config),
@@ -4989,6 +5007,7 @@ function createScavioTools(config) {
   createScavioSecFilingsTool,
   createScavioSecLookupTool,
   createScavioSecSearchTool,
+  createScavioTargetAvailabilityTool,
   createScavioTargetCategoryTool,
   createScavioTargetProductTool,
   createScavioTargetReviewsTool,