composio-scavio 0.5.2 → 0.6.0

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
@@ -31,7 +31,7 @@ Scavio is a single Search API over 31 platforms -- Google, YouTube, Amazon, Walm
 > result offset, not a page number** (0 is page 1, 10 is page 2), and there is no
 > `page` argument mapped onto it -- a silent remap fetches the wrong page.
 
-> **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`
@@ -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

@@ -1247,7 +1247,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "LINKEDIN_PERSON_ABOUT",
         "Scavio LinkedIn Person About",
-        "The about-only slice of a LinkedIn profile: about, headline, education_summary, experiences, educations, honors_and_awards and bio_links. Same upstream call as LINKEDIN_PERSON, shaped down. Costs 1 credit.",
+        "The about-only slice of a LinkedIn profile: about, headline, education_summary, experiences, educations, honors_and_awards and bio_links. Same lookup as LINKEDIN_PERSON, shaped down. Costs 1 credit.",
         import_zod.z.object({
           username: ostr("Public identifier / vanity handle. Provide this or url."),
           url: ostr("Full LinkedIn profile URL. Provide this or username.")
@@ -1547,7 +1547,7 @@ function buildScavioToolkit(options = {}) {
           query: ostr("Keyword to search (1-500 characters). Optional: a seller-only search pages that seller's whole catalogue."),
           seller: ostr("Restrict results to one seller's listings (1-64 characters), as in ebay.com/usr/<name>. Can be sent with no query."),
           page: onum("Results page, 1-based."),
-          sort_by: ostr("Result sort order. Defaults to 'best_match'. eBay's 'Distance: nearest first' is deliberately unsupported (it ranks against our proxy exit, not the caller). Accepted values: 'best_match', 'ending_soonest', 'newly_listed', 'price_low', 'price_high'."),
+          sort_by: ostr("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). Accepted values: 'best_match', 'ending_soonest', 'newly_listed', 'price_low', 'price_high'."),
           min_price: onum("Minimum price, inclusive. Must be 0 or greater."),
           max_price: onum("Maximum price, inclusive. Must be 0 or greater."),
           condition: ostr("Item condition filter. 'refurbished' is eBay's parent condition, not one of its three graded tiers. Accepted values: 'new', 'open_box', 'refurbished', 'used', 'for_parts'."),
@@ -1590,7 +1590,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 +1603,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 +1613,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 +1624,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)
       )
     );
   }
@@ -1750,7 +1762,7 @@ function buildScavioToolkit(options = {}) {
           adults: onum("Adult guests, >= 1 (default 2)."),
           children_ages: oarrnum("AGES of accompanying children, each 0-17, max 10 entries. Ages, not a count."),
           rooms: onum("Rooms required, >= 1 (default 1)."),
-          currency: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking prices off the proxy exit and identical requests disagree.")
+          currency: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking picks a currency itself and identical requests can disagree.")
         }),
         (i) => client.booking.search(i)
       ),
@@ -1766,7 +1778,7 @@ function buildScavioToolkit(options = {}) {
           adults: onum("Adult guests, >= 1 (default 2)."),
           children_ages: oarrnum("AGES of accompanying children, each 0-17, max 10 entries. Ages, not a count."),
           rooms: onum("Rooms required, >= 1 (default 1)."),
-          currency: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking prices off the proxy exit and identical requests disagree.")
+          currency: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking picks a currency itself and identical requests can disagree.")
         }),
         (i) => client.booking.hotel(i)
       ),
@@ -1912,7 +1924,7 @@ function buildScavioToolkit(options = {}) {
           guest_favorite: obool("Guest Favorite listings only."),
           free_cancellation: obool("Listings with free cancellation only."),
           amenities: ostr("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: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Airbnb prices off the proxy exit and identical requests disagree."),
+          currency: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Airbnb picks a currency itself and identical requests can disagree."),
           page: onum("Results page, 1-based. 18 listings per page. Cannot be combined with cursor."),
           cursor: ostr("next_cursor from a previous response (1-500 characters); wins over page, so sending both is rejected.")
         }),
@@ -1975,7 +1987,7 @@ function buildScavioToolkit(options = {}) {
         "Scavio Glassdoor Reviews",
         "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.",
         import_zod.z.object({
-          employer_id: ostr("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."),
+          employer_id: ostr("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: ostr("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."),
           url: ostr("Any glassdoor.com employer URL (1-500 characters). Pass back reviews_url from company() to skip the resolve fetch. A non-glassdoor.com host is rejected."),
           category: ostr("Restrict to reviews Glassdoor files under one topic. Closed enum: Glassdoor IGNORES an unknown value and serves the unfiltered set under a 200. Read filtered_review_count on the response to see how many match. Accepted values: 'career_development', 'compensation', 'culture', 'diversity_and_inclusion', 'management', 'work_life_balance'."),
@@ -1988,7 +2000,7 @@ function buildScavioToolkit(options = {}) {
         "Scavio Glassdoor Salaries",
         "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.",
         import_zod.z.object({
-          employer_id: ostr("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."),
+          employer_id: ostr("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: ostr("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."),
           url: ostr("Any glassdoor.com employer URL (1-500 characters). Pass back salaries_url from company() to skip the resolve fetch. A non-glassdoor.com host is rejected."),
           page: onum("Results page, 1-based. Ten job titles per page; page_count on the response is how many pages exist.")
@@ -2005,7 +2017,7 @@ function buildScavioToolkit(options = {}) {
         "Businesses in Yelp's ranked order: rating, review count, price band, categories, address, contact rails, hours, photos and a review snippet; every row carries both business_id and alias. Yelp fixes the page size at 10. Provide term and location, or url. Costs 2 credits.",
         import_zod.z.object({
           term: ostr("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: ostr("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."),
+          location: ostr("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: onum("Results page, 1-based. Yelp fixes the page size at 10."),
           sort: ostr("Result ordering (upstream default 'recommended'). Closed enum: Yelp IGNORES an unrecognised sortby and serves default ranking under a 200, billing a premium scrape for a sort that never ran. Accepted values: 'recommended', 'rating', 'review_count'."),
           price: oarrnum("Price bands to include, 1 ($) to 4 ($$$$); 1-4 values, combined freely - [1, 2] means $ or $$. Accepted values: 1, 2, 3, 4."),