mastra-scavio 0.7.3 → 0.8.0

package/README.md

@@ -1,6 +1,6 @@
 # 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 Amazon endpoint changed in 2026-07:
 > `domain` is replaced by `country`, a two-letter marketplace code (`us`, `gb`
@@ -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
 

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,
@@ -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");
@@ -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,