composio-scavio 0.5.3 → 0.6.1

package/README.md

@@ -2,7 +2,7 @@
 
 [Scavio](https://scavio.dev) real-time search tools for [Composio](https://composio.dev) (TypeScript).
 
-Scavio is a single Search API over 31 platforms -- Google, YouTube, Amazon, Walmart, eBay, Target, Home Depot, Reddit, TikTok, TikTok Shop, Instagram, X, LinkedIn, Threads, Kuaishou, Zillow, Redfin, Booking.com, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the Apple App Store, Google Play, SEC EDGAR, Companies House, G2, Capterra, Google Ads Transparency and the Meta Ad Library -- plus `extract`, which reads any URL as Markdown, plain text or raw HTML. This package exposes **194 tools** -- one per live endpoint plus five website tools that map, crawl and batch-extract whole sites -- as a Composio custom toolkit so your agents can pull structured, up-to-date results across any Composio-supported framework.
+Scavio is a single Search API over 31 platforms -- Google, YouTube, Amazon, Walmart, eBay, Target, Home Depot, Reddit, TikTok, TikTok Shop, Instagram, X, LinkedIn, Threads, Kuaishou, Zillow, Redfin, Booking.com, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the Apple App Store, Google Play, SEC EDGAR, Companies House, G2, Capterra, Google Ads Transparency and the Meta Ad Library -- plus `extract`, which reads any URL as Markdown, plain text or raw HTML. This package exposes **195 tools** -- one per live endpoint plus five website tools that map, crawl and batch-extract whole sites -- as a Composio custom toolkit so your agents can pull structured, up-to-date results across any Composio-supported framework.
 
 > **New in 0.5.0: website map, crawl and batch.** Five opt-in tools behind
 > `enableCrawl` -- see [Map, crawl and batch](#map-crawl-and-batch). Needs
@@ -122,7 +122,7 @@ All tools are grouped under the `SCAVIO` custom toolkit; agent-facing slugs are
 | Threads | `enableThreads` | 6 | profile, user posts, user replies, post, post comments, search users |
 | Kuaishou (China) | `enableKuaishou` | 14 | profile, user posts, user live, user resolve, video, video comments, comment replies, videos batch, search, search videos, search users, search live, tag feed, trending |
 | eBay | `enableEbay` | 3 | search, product, seller |
-| Target | `enableTarget` | 4 | search, category, product, reviews |
+| Target | `enableTarget` | 5 | search, category, product, reviews, availability |
 | Home Depot | `enableHomeDepot` | 3 | search, product, reviews |
 | Zillow | `enableZillow` | 3 | search, property, agent reviews |
 | Booking.com | `enableBooking` | 3 | search, hotel, reviews |
@@ -141,7 +141,7 @@ All tools are grouped under the `SCAVIO` custom toolkit; agent-facing slugs are
 | Google Ads Transparency | `enableGoogleAds` | 3 | advertisers, search, creative |
 | Meta Ad Library | `enableMetaAds` | 3 | search, advertiser, ad |
 | Website map, crawl, batch | `enableCrawl` | 5 | map website, crawl website, crawl status, batch extract, batch status |
-| **Total** | | **194** | |
+| **Total** | | **195** | |
 
 Two endpoints are deliberately not exposed:
 

package/dist/index.cjs

@@ -126,6 +126,8 @@ function buildScavioToolkit(options = {}) {
     enableCapterra = false,
     enableGoogleAds = false,
     enableMetaAds = false,
+    enableHeb = false,
+    enableKroger = false,
     enableCrawl = false,
     pollIntervalMs = JOB_POLL_INTERVAL_MS,
     all = false
@@ -1590,7 +1592,7 @@ function buildScavioToolkit(options = {}) {
           page: onum("Results page, 1-based."),
           count: onum("Results per page, 1-28. Defaults to 24; Target rejects anything above 28 outright."),
           sort: ostr("Result sort order. Defaults to 'relevance'. Accepted values: 'relevance', 'featured', 'price_low', 'price_high', 'rating_high', 'best_seller', 'newest'."),
-          store_id: ostr("Numeric Target store id whose prices and availability the response reflects. Defaults to '3991', the store target.com uses with no store context.")
+          store_id: ostr("Numeric Target store id whose prices the response reflects. Defaults to '3991', the store target.com uses with no store context.")
         }),
         (i) => client.target.search(i)
       ),
@@ -1603,7 +1605,7 @@ function buildScavioToolkit(options = {}) {
           page: onum("Results page, 1-based."),
           count: onum("Results per page, 1-28. Defaults to 24; Target rejects anything above 28 outright."),
           sort: ostr("Result sort order. Defaults to 'relevance'. Accepted values: 'relevance', 'featured', 'price_low', 'price_high', 'rating_high', 'best_seller', 'newest'."),
-          store_id: ostr("Numeric Target store id whose prices and availability the response reflects. Defaults to '3991'.")
+          store_id: ostr("Numeric Target store id whose prices the response reflects. Defaults to '3991'.")
         }),
         (i) => client.target.category(i)
       ),
@@ -1613,7 +1615,7 @@ function buildScavioToolkit(options = {}) {
         "Target product details by TCIN: price, rating, images, specifications, variants, return policy, fulfillment. seller_id/seller_name are null for stock sold by Target. Costs 1 credit.",
         import_zod.z.object({
           tcin: str("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: ostr("Numeric Target store id whose prices and availability the response reflects. Defaults to '3991'.")
+          store_id: ostr("Numeric Target store id whose prices the response reflects. Defaults to '3991'.")
         }),
         (i) => client.target.product(i)
       ),
@@ -1624,9 +1626,21 @@ function buildScavioToolkit(options = {}) {
         import_zod.z.object({
           tcin: str("Target catalog id (tcin, e.g. '1010453160')."),
           limit: onum("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: ostr("Numeric Target store id whose prices and availability the response reflects. Defaults to '3991'.")
+          store_id: ostr("Numeric Target store id whose prices the response reflects. Defaults to '3991'.")
         }),
         (i) => client.target.reviews(i)
+      ),
+      tool(
+        "TARGET_AVAILABILITY",
+        "Scavio Target Availability",
+        "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.",
+        import_zod.z.object({
+          tcin: str("Target catalog id (tcin, e.g. '85978609')."),
+          zip: str("5-digit US ZIP code to search around."),
+          radius: onum("Search radius in miles, 1-100. Defaults to 25. At most 20 stores."),
+          store_id: ostr("Return only this Target store. It must be within radius of zip.")
+        }),
+        (i) => client.target.availability(i)
       )
     );
   }
@@ -2468,6 +2482,67 @@ function buildScavioToolkit(options = {}) {
       )
     );
   }
+  if (all || enableHeb) {
+    tools.push(
+      tool(
+        "HEB_SEARCH",
+        "Scavio HEB Search",
+        "Search HEB grocery products: price in cents, sale status, unit price, size, UPC, stock, EBT/SNAP eligibility, aisle location and product URL. Costs 2 credits.",
+        import_zod.z.object({
+          query: str("Search keywords (1-200 characters)."),
+          page: onum("Results page, 1-based (1-100)."),
+          page_size: onum("Results per page, 1-60. Server default 30.")
+        }),
+        (i) => client.heb.search(i)
+      ),
+      tool(
+        "HEB_PRODUCT",
+        "Scavio HEB Product",
+        "Full HEB product detail: nutrition facts, ingredients, description, images, similar products, coupons, EBT/SNAP eligibility and breadcrumbs. Pass product_url (from search) or slug + product_id. Costs 2 credits.",
+        import_zod.z.object({
+          product_url: ostr("Full or relative product URL from heb.com. Preferred over slug + product_id."),
+          product_id: ostr("HEB product id (numeric id at the end of a product URL). Requires slug."),
+          slug: ostr("Product slug (readable part of the URL). Required with product_id.")
+        }),
+        (i) => client.heb.product(i)
+      ),
+      tool(
+        "HEB_STORES",
+        "Scavio HEB Stores",
+        "HEB stores near a US ZIP code or city: store number, address, phone, hours, pharmacy availability, fulfillment channels, distance and store URL. Pass zip or city. Costs 2 credits.",
+        import_zod.z.object({
+          zip: ostr("5-digit US ZIP code (e.g. '78701')."),
+          city: ostr("City name (e.g. 'Austin'). Pass zip or city.")
+        }),
+        (i) => client.heb.stores(i)
+      )
+    );
+  }
+  if (all || enableKroger) {
+    tools.push(
+      tool(
+        "KROGER_SEARCH",
+        "Scavio Kroger Search",
+        "Search Kroger grocery products: price in cents, promo price, n-for deals, unit price, size, UPC, stock, SNAP eligibility, dietary info, rating and category. Kroger operates Kroger, Ralphs, Fred Meyer, Harris Teeter, King Soopers and Fry's. Costs 2 credits.",
+        import_zod.z.object({
+          query: str("Search keywords (1-200 characters)."),
+          page: onum("Results page, 1-based (1-100).")
+        }),
+        (i) => client.kroger.search(i)
+      ),
+      tool(
+        "KROGER_PRODUCT",
+        "Scavio Kroger Product",
+        "Full Kroger product detail by URL or UPC: nutrition facts, allergens, ingredients, nutrients with daily values, description, images, rating distribution, store aisle, stock, dietary flags, SNAP eligibility, dimensions and country of origin. Costs 2 credits.",
+        import_zod.z.object({
+          product_url: ostr("Full or relative product URL from kroger.com. Preferred."),
+          upc: ostr("Kroger product UPC (from search or product URLs: /p/{slug}/{upc})."),
+          slug: ostr("Product slug for readable URL. Optional with upc.")
+        }),
+        (i) => client.kroger.product(i)
+      )
+    );
+  }
   if (all || enableExtract) {
     tools.push(
       tool(
@@ -2571,7 +2646,7 @@ function buildScavioToolkit(options = {}) {
   }
   return (0, import_core.experimental_createToolkit)("SCAVIO", {
     name: "Scavio",
-    description: "Real-time structured search over 31 platforms - Google (SERP, AI Mode, Maps, Shopping, Flights, Hotels, News, Trends), YouTube, Amazon, Walmart, eBay, Target, Home Depot, Reddit, TikTok, TikTok Shop, Instagram, X, LinkedIn, Threads, Kuaishou, Zillow, Redfin, Booking.com, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the Apple App Store, Google Play, SEC EDGAR, Companies House, G2, Capterra, Google Ads Transparency and the Meta Ad Library - plus extract, which reads any URL as Markdown, plain text or raw HTML, and website map, crawl and batch extract.",
+    description: "Real-time structured search over 33 platforms - Google (SERP, AI Mode, Maps, Shopping, Flights, Hotels, News, Trends), YouTube, Amazon, Walmart, eBay, Target, Home Depot, HEB, Kroger, Reddit, TikTok, TikTok Shop, Instagram, X, LinkedIn, Threads, Kuaishou, Zillow, Redfin, Booking.com, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the Apple App Store, Google Play, SEC EDGAR, Companies House, G2, Capterra, Google Ads Transparency and the Meta Ad Library - plus extract, which reads any URL as Markdown, plain text or raw HTML, and website map, crawl and batch extract.",
     tools
   });
 }