composio-scavio 0.3.0 → 0.4.1

package/dist/index.cjs

@@ -31,6 +31,11 @@ var str = (d) => import_zod.z.string().describe(d);
 var ostr = (d) => import_zod.z.string().optional().describe(d);
 var onum = (d) => import_zod.z.number().optional().describe(d);
 var obool = (d) => import_zod.z.boolean().optional().describe(d);
+var arrstr = (d) => import_zod.z.array(import_zod.z.string()).describe(d);
+var oarrstr = (d) => import_zod.z.array(import_zod.z.string()).optional().describe(d);
+var oarrnum = (d) => import_zod.z.array(import_zod.z.number()).optional().describe(d);
+var ostrnum = (d) => import_zod.z.union([import_zod.z.string(), import_zod.z.number()]).optional().describe(d);
+var ostrarr = (d) => import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.string())]).optional().describe(d);
 var gl = ostr("Country of the search (ISO 3166-1 alpha-2, e.g. 'us', 'gb', 'de').");
 var hl = ostr("UI language (ISO 639-1, e.g. 'en').");
 var googleDomain = ostr("Regional Google domain, e.g. 'google.co.uk'.");
@@ -52,6 +57,28 @@ function buildScavioToolkit(options = {}) {
     enableInstagram = true,
     enableX = true,
     enableLinkedin = true,
+    enableExtract = true,
+    enableThreads = false,
+    enableKuaishou = false,
+    enableEbay = false,
+    enableTarget = false,
+    enableHomeDepot = false,
+    enableZillow = false,
+    enableBooking = false,
+    enableTripadvisor = false,
+    enableIndeed = false,
+    enableAirbnb = false,
+    enableGlassdoor = false,
+    enableYelp = false,
+    enableAppStore = false,
+    enableGooglePlay = false,
+    enableSec = false,
+    enableRedfin = false,
+    enableCompaniesHouse = false,
+    enableG2 = false,
+    enableCapterra = false,
+    enableGoogleAds = false,
+    enableMetaAds = false,
     all = false
   } = options;
   const client = new import_scavio.Scavio({ apiKey: apiKey ?? process.env.SCAVIO_API_KEY });
@@ -337,6 +364,13 @@ function buildScavioToolkit(options = {}) {
           country: ostr("Marketplace country code (ISO 3166-1 alpha-2), not a domain: 'us' (default), 'gb' (the UK is gb, not uk), 'ca', 'de', 'fr', 'es', 'it', 'jp', 'in', 'au', 'br', 'mx', 'nl', 'pl', 'se', 'sg', 'ae', 'sa', 'eg', 'cn', 'be', 'tr'. An unknown code falls back to us.")
         }),
         (i) => client.amazon.offers(i)
+      ),
+      tool(
+        "AMAZON_OPTIONS",
+        "Scavio Amazon Options",
+        "Supported Amazon marketplaces, as 'domains' and 'countries'. 'languages' and 'currencies' remain in the payload but are always empty: neither is a request param any more. Needs no API key and costs no credits.",
+        import_zod.z.object({}),
+        () => client.amazon.options()
       )
     );
   }
@@ -345,34 +379,82 @@ function buildScavioToolkit(options = {}) {
       tool(
         "WALMART_SEARCH",
         "Scavio Walmart Search",
-        "Search Walmart for products matching a query. Costs 1 credit.",
+        "Search Walmart and get structured product rows (products, products_count and the store the results were priced against). Costs 1 credit on domain 'com' or 'ca' and 2 credits on 'com.mx' - the price is a function of the request body, not a constant for the route.",
         import_zod.z.object({
-          query: str("The product search query."),
-          domain: ostr("Walmart domain."),
-          device: ostr("Device profile: 'desktop' or 'mobile'."),
-          sort_by: ostr("Sort order for results."),
-          start_page: onum("First page to return."),
-          min_price: onum("Minimum price filter."),
-          max_price: onum("Maximum price filter."),
-          fulfillment_speed: ostr("Fulfillment speed filter."),
-          fulfillment_type: ostr("Fulfillment type filter."),
-          delivery_zip: ostr("Delivery ZIP/postal code."),
-          store_id: ostr("Restrict to a store id.")
+          query: str("Product search query (1-500 characters)."),
+          domain: ostr("Marketplace: 'com' (US, default, 1 credit), 'ca' (1 credit), 'com.mx' (2 credits). Sets the currency and product URLs of the response."),
+          page: onum("Results page, 1-based (integer >= 1). One page per call."),
+          start_page: onum("Deprecated alias for page; send page instead."),
+          sort_by: ostr("Result sort order. Defaults to 'best_match'. Accepted values: 'best_match', 'price_low', 'price_high', 'best_seller', 'rating_high', 'new'."),
+          min_price: onum("Minimum price filter in the marketplace's own currency; decimals allowed (e.g. 19.99)."),
+          max_price: onum("Maximum price filter in the marketplace's own currency; decimals allowed (e.g. 199.5)."),
+          fulfillment_speed: ostr("Only items deliverable today, or by tomorrow. '2_days' and 'anytime' are not accepted - for anytime, omit this parameter."),
+          fulfillment_type: ostr("Set to 'in_store' to return only items available for in-store pickup.")
         }),
         (i) => client.walmart.search(i)
       ),
       tool(
         "WALMART_PRODUCT",
         "Scavio Walmart Product",
-        "Fetch full Walmart product details by product id. Costs 1 credit.",
+        "Full detail for a single Walmart product: price, rating, images, specifications, availability and seller. US marketplace only - walmart.ca product pages could not be fetched at all, so this endpoint takes no domain. Costs 1 credit: Walmart is body-priced through `domain`, but this endpoint takes no domain, so it is always 1.",
         import_zod.z.object({
-          product_id: str("Walmart product id."),
-          domain: ostr("Walmart domain."),
-          device: ostr("Device profile: 'desktop' or 'mobile'."),
-          delivery_zip: ostr("Delivery ZIP/postal code."),
-          store_id: ostr("Restrict to a store id.")
+          product_id: str("Walmart item id (usItemId), e.g. '13544111159'.")
         }),
         (i) => client.walmart.product(i)
+      ),
+      tool(
+        "WALMART_REVIEWS",
+        "Scavio Walmart Reviews",
+        "Customer reviews for a Walmart product with ratings, text, author, date and the rating breakdown. 10 reviews per page; paginate with page. Costs 1 credit: Walmart is body-priced through `domain`, but this endpoint takes no domain, so it is always 1.",
+        import_zod.z.object({
+          product_id: str("Walmart item id (usItemId), e.g. '13544111159'."),
+          page: onum("Reviews page, 1-based (integer >= 1). 10 reviews per page."),
+          sort: ostr("Review sort order. Omit for Walmart's own default ordering. Accepted values: 'relevancy', 'submission-desc', 'submission-asc', 'rating-desc', 'rating-asc', 'helpful-desc'.")
+        }),
+        (i) => client.walmart.reviews(i)
+      ),
+      tool(
+        "WALMART_CATEGORY",
+        "Scavio Walmart Category",
+        "Products within a Walmart category, in the same product shape as search. Costs 1 credit on domain 'com' or 'ca' and 2 credits on 'com.mx' - the price is a function of the request body, not a constant for the route.",
+        import_zod.z.object({
+          category_id: str("Walmart category id: either a leaf id ('1095191') or the full underscore-joined path ('3944_133251_1095191'). Both are accepted."),
+          domain: ostr("Marketplace: 'com' (US, default, 1 credit), 'ca' (1 credit), 'com.mx' (2 credits). Sets the currency and product URLs of the response."),
+          page: onum("Results page, 1-based (integer >= 1). One page per call."),
+          limit: onum("Trim the returned products to at most this many (integer >= 1). Applied after fetching, so it does not reduce the credit cost of the call."),
+          sort_by: ostr("Result sort order. Defaults to 'best_match'. Accepted values: 'best_match', 'price_low', 'price_high', 'best_seller', 'rating_high', 'new'."),
+          min_price: onum("Minimum price filter in the marketplace's own currency; decimals allowed (e.g. 19.99)."),
+          max_price: onum("Maximum price filter in the marketplace's own currency; decimals allowed (e.g. 199.5)."),
+          fulfillment_speed: ostr("Only items deliverable today, or by tomorrow. '2_days' and 'anytime' are not accepted - for anytime, omit this parameter.")
+        }),
+        (i) => client.walmart.category(i)
+      ),
+      tool(
+        "WALMART_OFFERS",
+        "Scavio Walmart Offers",
+        "The buy-box offer for a Walmart product: price, seller, condition and buy-box flag. BUY-BOX SELLER ONLY - this is not the full offer list, and there is no way to page through the other sellers. Costs 1 credit: Walmart is body-priced through `domain`, but this endpoint takes no domain, so it is always 1.",
+        import_zod.z.object({
+          product_id: str("Walmart item id (usItemId), e.g. '2979510112'.")
+        }),
+        (i) => client.walmart.offers(i)
+      ),
+      tool(
+        "WALMART_SELLER",
+        "Scavio Walmart Seller",
+        "Marketplace seller storefront: name, rating, review count, Pro Seller badge and business details. Costs 1 credit: Walmart is body-priced through `domain`, but this endpoint takes no domain, so it is always 1.",
+        import_zod.z.object({
+          seller_id: str("Numeric Walmart catalog seller id, as returned in `seller_catalog_id` on a product, search or offers response (e.g. '101480084'). The GUID `seller_id` is not accepted here - it 404s.")
+        }),
+        (i) => client.walmart.seller(i)
+      ),
+      tool(
+        "WALMART_SELLER_PRODUCTS",
+        "Scavio Walmart Seller Products",
+        "A marketplace seller's catalog. Roughly the first 40 items are server-rendered and returned; total_count reports the seller's real catalog size. There is no pagination - the rest of the catalog is not reachable. Costs 1 credit: Walmart is body-priced through `domain`, but this endpoint takes no domain, so it is always 1.",
+        import_zod.z.object({
+          seller_id: str("Numeric Walmart catalog seller id, as returned in `seller_catalog_id` on a product, search or offers response (e.g. '101480084'). The GUID `seller_id` 404s.")
+        }),
+        (i) => client.walmart.sellerProducts(i)
       )
     );
   }
@@ -1200,9 +1282,1161 @@ function buildScavioToolkit(options = {}) {
       )
     );
   }
+  if (all || enableThreads) {
+    tools.push(
+      tool(
+        "THREADS_PROFILE",
+        "Scavio Threads Profile",
+        "Profile details for a Threads user. Costs 2 credits addressed by user_id and 4 credits addressed by username - the price is a function of the request body, not a constant for the route; pass user_id whenever you have it.",
+        import_zod.z.object({
+          user_id: ostr("Numeric Threads user id, e.g. '63625256886'. The cheap path: 2 credits."),
+          username: ostr("Threads handle without the @ (1-60 characters). Costs 2 extra credits (4 total): the upstream handle lookup is down, so the handle is resolved through people search first. Pass user_id instead to avoid that.")
+        }),
+        (i) => client.threads.profile(i)
+      ),
+      tool(
+        "THREADS_USER_POSTS",
+        "Scavio Threads User Posts",
+        "A user's Threads posts, cursor-paginated via next_cursor. Costs 2 credits addressed by user_id and 4 credits addressed by username - the price is a function of the request body, not a constant for the route; pass user_id whenever you have it.",
+        import_zod.z.object({
+          user_id: ostr("Numeric Threads user id, e.g. '63625256886'. The cheap path: 2 credits."),
+          username: ostr("Threads handle without the @ (1-60 characters). Costs 2 extra credits (4 total) because the handle has to be resolved through people search first."),
+          cursor: ostr("Pagination cursor from a prior response's next_cursor. Omit for the first page.")
+        }),
+        (i) => client.threads.userPosts(i)
+      ),
+      tool(
+        "THREADS_USER_REPLIES",
+        "Scavio Threads User Replies",
+        "A user's Threads replies, cursor-paginated via next_cursor. Costs 2 credits addressed by user_id and 4 credits addressed by username - the price is a function of the request body, not a constant for the route; pass user_id whenever you have it.",
+        import_zod.z.object({
+          user_id: ostr("Numeric Threads user id, e.g. '63625256886'. The cheap path: 2 credits."),
+          username: ostr("Threads handle without the @ (1-60 characters). Costs 2 extra credits (4 total) because the handle has to be resolved through people search first."),
+          cursor: ostr("Pagination cursor from a prior response's next_cursor. Omit for the first page.")
+        }),
+        (i) => client.threads.userReplies(i)
+      ),
+      tool(
+        "THREADS_POST",
+        "Scavio Threads Post",
+        "A single Threads post, addressed by post_id or by its threads.net URL. Costs 2 credits: Threads is body-priced by identifier, but this endpoint has no username form, so it is always 2.",
+        import_zod.z.object({
+          post_id: ostr("Threads post id, e.g. '3349029093483693129'."),
+          url: ostr("Full threads.net post URL (e.g. 'https://www.threads.net/@natgeo/post/C8xY'), as an alternative to post_id.")
+        }),
+        (i) => client.threads.post(i)
+      ),
+      tool(
+        "THREADS_POST_COMMENTS",
+        "Scavio Threads Post Comments",
+        "Replies to a Threads post, cursor-paginated via next_cursor. Costs 2 credits: Threads is body-priced by identifier, but this endpoint has no username form, so it is always 2.",
+        import_zod.z.object({
+          post_id: str("Threads post id, e.g. '3349029093483693129'."),
+          cursor: ostr("Pagination cursor from a prior response's next_cursor. Omit for the first page.")
+        }),
+        (i) => client.threads.postComments(i)
+      ),
+      tool(
+        "THREADS_SEARCH_USERS",
+        "Scavio Threads Search Users",
+        "Search Threads profiles by name or handle. This is the only search Threads exposes - there is no post or content search - and it returns a single unpaginated page. Costs 2 credits: Threads is body-priced by identifier, but this endpoint has no username form, so it is always 2.",
+        import_zod.z.object({
+          query: str("Name or handle to search for (1-200 characters).")
+        }),
+        (i) => client.threads.searchUsers(i)
+      )
+    );
+  }
+  if (all || enableKuaishou) {
+    tools.push(
+      tool(
+        "KUAISHOU_PROFILE",
+        "Scavio Kuaishou Profile",
+        "Profile details for a Kuaishou user. Costs 10 credits, the dearest single-object call on the platform: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          user_id: str("Kuaishou user id (non-empty); get one from user_resolve or search_users.")
+        }),
+        (i) => client.kuaishou.profile(i)
+      ),
+      tool(
+        "KUAISHOU_USER_POSTS",
+        "Scavio Kuaishou User Posts",
+        "A Kuaishou user's top posts, cursor-paginated via next_cursor. Costs 1 credit: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          user_id: str("Kuaishou user id (non-empty); get one from user_resolve or search_users."),
+          cursor: ostr("Opaque next_cursor from a prior response; omit for the first page.")
+        }),
+        (i) => client.kuaishou.userPosts(i)
+      ),
+      tool(
+        "KUAISHOU_USER_LIVE",
+        "Scavio Kuaishou User Live",
+        "A Kuaishou user's current live-stream status. Not paginated. Costs 1 credit: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          user_id: str("Kuaishou user id (non-empty); get one from user_resolve or search_users.")
+        }),
+        (i) => client.kuaishou.userLive(i)
+      ),
+      tool(
+        "KUAISHOU_USER_RESOLVE",
+        "Scavio Kuaishou User Resolve",
+        "Turns a Kuaishou share link into a user id. Only kuaishou.com and v.kuaishou.com links are accepted; Kwai international (kwai.com) is not served upstream. Costs 1 credit: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          share_link: str("A kuaishou.com or v.kuaishou.com URL; kwai.com links are rejected.")
+        }),
+        (i) => client.kuaishou.userResolve(i)
+      ),
+      tool(
+        "KUAISHOU_VIDEO",
+        "Scavio Kuaishou Video",
+        "A single Kuaishou video by photo id or URL. Provide photo_id or url. Costs 2 credits: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          photo_id: ostr("Kuaishou photo (video) id, non-empty."),
+          url: ostr("Full kuaishou.com video URL, as an alternative to photo_id.")
+        }),
+        (i) => client.kuaishou.video(i)
+      ),
+      tool(
+        "KUAISHOU_VIDEO_COMMENTS",
+        "Scavio Kuaishou Video Comments",
+        "Comments on a Kuaishou video, cursor-paginated via next_cursor. Costs 1 credit: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          photo_id: str("Kuaishou photo (video) id, non-empty."),
+          cursor: ostr("Opaque next_cursor from a prior response; omit for the first page.")
+        }),
+        (i) => client.kuaishou.videoComments(i)
+      ),
+      tool(
+        "KUAISHOU_COMMENT_REPLIES",
+        "Scavio Kuaishou Comment Replies",
+        "Replies under a root comment on a Kuaishou video, cursor-paginated via next_cursor; count sizes the page (1-50). Costs 1 credit: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          photo_id: str("Kuaishou photo (video) id, non-empty."),
+          root_comment_id: str("Id of the top-level comment whose replies you want, from video_comments."),
+          cursor: ostr("Opaque next_cursor from a prior response; omit for the first page."),
+          count: onum("Replies per page, 1-50. Omit to use the upstream default.")
+        }),
+        (i) => client.kuaishou.commentReplies(i)
+      ),
+      tool(
+        "KUAISHOU_VIDEOS_BATCH",
+        "Scavio Kuaishou Videos Batch",
+        "Several Kuaishou videos in one call, hard-capped at 20 photo ids. Costs 40 credits, the dearest call on the platform: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          photo_ids: arrstr("Kuaishou photo (video) ids, 1-20 per call; more than 20 is rejected.")
+        }),
+        (i) => client.kuaishou.videosBatch(i)
+      ),
+      tool(
+        "KUAISHOU_SEARCH",
+        "Scavio Kuaishou Search",
+        "Mixed-result search across Kuaishou, cursor-paginated via next_cursor. Costs 10 credits per page: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          keyword: str("Search keyword, 1-200 characters."),
+          cursor: ostr("Opaque next_cursor from a prior response; omit for the first page.")
+        }),
+        (i) => client.kuaishou.search(i)
+      ),
+      tool(
+        "KUAISHOU_SEARCH_VIDEOS",
+        "Scavio Kuaishou Search Videos",
+        "Kuaishou video search results, cursor-paginated via next_cursor. Costs 10 credits per page: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          keyword: str("Search keyword, 1-200 characters."),
+          cursor: ostr("Opaque next_cursor from a prior response; omit for the first page.")
+        }),
+        (i) => client.kuaishou.searchVideos(i)
+      ),
+      tool(
+        "KUAISHOU_SEARCH_USERS",
+        "Scavio Kuaishou Search Users",
+        "Kuaishou user search results, cursor-paginated via next_cursor. Costs 10 credits per page: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          keyword: str("Search keyword, 1-200 characters."),
+          cursor: ostr("Opaque next_cursor from a prior response; omit for the first page.")
+        }),
+        (i) => client.kuaishou.searchUsers(i)
+      ),
+      tool(
+        "KUAISHOU_SEARCH_LIVE",
+        "Scavio Kuaishou Search Live",
+        "Kuaishou live-stream search results, cursor-paginated via next_cursor. Costs 10 credits per page: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          keyword: str("Search keyword, 1-200 characters."),
+          cursor: ostr("Opaque next_cursor from a prior response; omit for the first page.")
+        }),
+        (i) => client.kuaishou.searchLive(i)
+      ),
+      tool(
+        "KUAISHOU_TAG_FEED",
+        "Scavio Kuaishou Tag Feed",
+        "Posts under a Kuaishou hashtag, cursor-paginated via next_cursor. Costs 1 credit: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          tag: str("Hashtag text without the leading '#', 1-200 characters."),
+          cursor: ostr("Opaque next_cursor from a prior response; omit for the first page.")
+        }),
+        (i) => client.kuaishou.tagFeed(i)
+      ),
+      tool(
+        "KUAISHOU_TRENDING",
+        "Scavio Kuaishou Trending",
+        "Kuaishou hot / live / shopping / brand / music leaderboards. One board per call, not paginated. Costs 1 credit: Kuaishou is priced PER ENDPOINT (1, 2, 10 or 40), never per platform.",
+        import_zod.z.object({
+          board: ostr("Leaderboard to return; defaults to 'hot' when omitted. Accepted values: 'hot', 'live', 'shopping', 'brand', 'music'.")
+        }),
+        (i) => client.kuaishou.trending(i)
+      )
+    );
+  }
+  if (all || enableEbay) {
+    tools.push(
+      tool(
+        "EBAY_SEARCH",
+        "Scavio eBay Search",
+        "Search live or SOLD eBay listings: price, condition, bids, shipping, seller, feedback. Provide query or seller; per_page accepts only 60, 120 or 240. Costs 1 credit.",
+        import_zod.z.object({
+          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'."),
+          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'."),
+          buying_format: ostr("Listing format: auction, fixed price (buy_it_now), or fixed price accepting offers (best_offer)."),
+          free_shipping: obool("Only listings with free shipping."),
+          sold: obool("Search completed listings that actually SOLD, for price research. eBay publishes no headline count on this view, so total_results is null."),
+          category_id: ostr("eBay category id; must be numeric (e.g. '112529'). An unrecognised id returns the UNFILTERED set under a 200."),
+          per_page: onum("Listings per page: 60, 120 or 240 only. Defaults to 60; eBay silently falls back to 60 for anything else.")
+        }),
+        (i) => client.ebay.search(i)
+      ),
+      tool(
+        "EBAY_PRODUCT",
+        "Scavio eBay Product",
+        "One eBay listing in full: price, condition, images, item specifics, shipping, returns, auction state, seller. Costs 1 credit.",
+        import_zod.z.object({
+          item_id: str("eBay item number (e.g. '168591664725'), or a full ebay.com/itm/... listing URL; tracking parameters on a pasted URL are discarded.")
+        }),
+        (i) => client.ebay.product(i)
+      ),
+      tool(
+        "EBAY_SELLER",
+        "Scavio eBay Seller",
+        "eBay seller profile card: store name, feedback score and %, items sold, followers, location, categories. Profile only: page a catalogue with search(seller=...). Costs 1 credit.",
+        import_zod.z.object({
+          seller: str("eBay username as it appears in ebay.com/usr/<name> (1-64 characters), which is what seller_name on a search or product result returns.")
+        }),
+        (i) => client.ebay.seller(i)
+      )
+    );
+  }
+  if (all || enableTarget) {
+    tools.push(
+      tool(
+        "TARGET_SEARCH",
+        "Scavio Target Search",
+        "Search Target.com, the US retailer: prices, ratings, badges and promotions. Up to 28 results per page; rendered upstream, so expect around 9 seconds. Costs 1 credit.",
+        import_zod.z.object({
+          keyword: str("Search keyword (1-500 characters)."),
+          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.")
+        }),
+        (i) => client.target.search(i)
+      ),
+      tool(
+        "TARGET_CATEGORY",
+        "Scavio Target Category",
+        "Products in a Target category, same shape as search plus the category breadcrumb. Up to 28 per page; the slowest Target endpoint at around 37 seconds. Costs 1 credit.",
+        import_zod.z.object({
+          category_id: str("Target category id: the segment after 'N-' in a target.com /c/ URL (target.com/c/apple/-/N-5xtg6 -> '5xtg6')."),
+          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'.")
+        }),
+        (i) => client.target.category(i)
+      ),
+      tool(
+        "TARGET_PRODUCT",
+        "Scavio Target Product",
+        "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'.")
+        }),
+        (i) => client.target.product(i)
+      ),
+      tool(
+        "TARGET_REVIEWS",
+        "Scavio Target Reviews",
+        "Target reviews with the rating breakdown, per-attribute averages and guest photos. 8 review bodies maximum and no paging; expect around 40 seconds. Costs 1 credit.",
+        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'.")
+        }),
+        (i) => client.target.reviews(i)
+      )
+    );
+  }
+  if (all || enableHomeDepot) {
+    tools.push(
+      tool(
+        "HOME_DEPOT_SEARCH",
+        "Scavio Home Depot Search",
+        "Search Home Depot: price and promotions, brand and model, ratings, badges, per-store pickup/delivery. Page size is fixed at 12 and cannot be changed. Costs 2 credits.",
+        import_zod.z.object({
+          query: str("Search keyword (1-500 characters)."),
+          page: onum("Results page, 1-based. Home Depot serves 12 products per page and offers no way to change that, so paging is the only way to read further."),
+          sort_by: ostr("Result sort order. Defaults to 'best_match'. Closed enum: Home Depot answers an unknown sort with an empty page that is still billed. 'Newest' is absent - it is rejected on keyword search. Accepted values: 'best_match', 'top_sellers', 'top_rated', '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.")
+        }),
+        (i) => client.homeDepot.search(i)
+      ),
+      tool(
+        "HOME_DEPOT_PRODUCT",
+        "Scavio Home Depot Product",
+        "Full Home Depot item detail: pricing, images and videos, spec table, dimensions, bullets, documents, return policy. Carries a 10-review preview only. Costs 2 credits.",
+        import_zod.z.object({
+          item_id: str("Home Depot item id (e.g. '325479354'), or a full homedepot.com/p/... product URL; tracking parameters on a pasted URL are discarded.")
+        }),
+        (i) => client.homeDepot.product(i)
+      ),
+      tool(
+        "HOME_DEPOT_REVIEWS",
+        "Scavio Home Depot Reviews",
+        "One page of full Home Depot review bodies, the rating distribution, per-attribute ratings, photos and seller responses. 30 reviews per page. Costs 2 credits.",
+        import_zod.z.object({
+          item_id: str("Home Depot item id (e.g. '325479354'), or a full homedepot.com/p/... product URL; tracking parameters on a pasted URL are discarded."),
+          page: onum("Reviews page, 1-based. 30 reviews per page; 'total_pages' in the response is the last one that exists, and asking past it is a 404.")
+        }),
+        (i) => client.homeDepot.reviews(i)
+      )
+    );
+  }
+  if (all || enableZillow) {
+    tools.push(
+      tool(
+        "ZILLOW_SEARCH",
+        "Scavio Zillow Search",
+        "Zillow listings in a region: price, beds, baths, living area, Zestimate, coordinates, images, days on market. A bare ZIP works alone but cannot be combined with a filter or a sort. Costs 1 credit.",
+        import_zod.z.object({
+          location: str("Region to search (1-200 characters): a Zillow slug ('austin-tx'), a human form ('Austin, TX'), a ZIP, or a pasted zillow.com search URL. A ZIP works alone but cannot be combined with a filter or sort; an unresolvable region is a 404."),
+          listing_status: ostr("Which listings to return. Defaults to 'for_sale'. Accepted values: 'for_sale', 'for_rent', 'sold'."),
+          page: onum("Results page, 1-based."),
+          sort: ostr("Result sort order. Sorts that rank against a signed-in profile (saved/featured/personalised) are unsupported - we are never signed in. Accepted values: 'relevance', 'recommended', 'newest', 'price_low', 'price_high', 'payment_low', 'payment_high', 'beds', 'baths', 'sqft', 'lot_size', 'zestimate_low', 'zestimate_high', 'recent_change'."),
+          min_price: onum("Minimum price, inclusive (0 or greater). On listing_status='for_rent' this is MONTHLY RENT - Zillow files rent under its payment filter."),
+          max_price: onum("Maximum price, inclusive (0 or greater). On listing_status='for_rent' this is MONTHLY RENT."),
+          beds_min: onum("Minimum bedrooms; whole number, 0 or greater."),
+          beds_max: onum("Maximum bedrooms; whole number, 0 or greater."),
+          baths_min: onum("Minimum bathrooms, 0 or greater. Half-baths are allowed (1.5)."),
+          baths_max: onum("Maximum bathrooms, 0 or greater. Half-baths are allowed (1.5)."),
+          sqft_min: onum("Minimum living area in square feet; whole number, 0 or greater."),
+          sqft_max: onum("Maximum living area in square feet; whole number, 0 or greater."),
+          lot_size_min: onum("Minimum lot size in square feet; whole number, 0 or greater."),
+          lot_size_max: onum("Maximum lot size in square feet; whole number, 0 or greater."),
+          year_built_min: onum("Earliest year built; whole number, 0 or greater."),
+          year_built_max: onum("Latest year built; whole number, 0 or greater."),
+          max_hoa: onum("Maximum monthly HOA fee in dollars, 0 or greater."),
+          home_type: ostr("Property type filter. Accepted values: 'houses', 'townhomes', 'multi_family', 'condos', 'apartments', 'manufactured', 'lots_land'."),
+          days_on_zillow: ostr("Listed - or, with listing_status='sold', sold - within the last N days. Closed enum: an unrecognised value returns the UNFILTERED set under a 200. Accepted values: '1', '7', '14', '30', '90', '6m', '12m', '24m', '36m'."),
+          keywords: ostr("Free-text match against the listing description (1-200 characters)."),
+          has_pool: obool("Only listings with a pool."),
+          has_garage: obool("Only listings with a garage."),
+          has_air_conditioning: obool("Only listings with air conditioning."),
+          is_waterfront: obool("Only waterfront listings."),
+          has_basement: obool("Only listings with a basement."),
+          is_new_construction: obool("Only new-construction listings."),
+          has_open_house: obool("Only listings with an upcoming open house."),
+          price_reduced: obool("Only listings whose price was reduced."),
+          is_3d_tour: obool("Only listings with a 3D tour.")
+        }),
+        (i) => client.zillow.search(i)
+      ),
+      tool(
+        "ZILLOW_PROPERTY",
+        "Scavio Zillow Property",
+        "Full Zillow listing: price and price history, Zestimate, tax history, RESO facts, rooms, schools, open houses, photos. Rental buildings return floor plans instead. Costs 1 credit.",
+        import_zod.z.object({
+          zpid: str("Zillow property id (e.g. '29414894'), a full /homedetails/ URL, or a rental building URL (zillow.com/apartments/...). The building form is required for buildings: they have no zpid a caller can see.")
+        }),
+        (i) => client.zillow.property(i)
+      ),
+      tool(
+        "ZILLOW_AGENT_REVIEWS",
+        "Scavio Zillow Agent Reviews",
+        "A Zillow AGENT's profile and reviews: rating, bodies with sub-ratings, specialties, licenses, service areas, sales counts. Zillow server-renders the first five. Costs 1 credit.",
+        import_zod.z.object({
+          screen_name: str("Zillow agent profile screen name as it appears in zillow.com/profile/<name>/ (1-200 characters, may contain spaces), or a full profile URL.")
+        }),
+        (i) => client.zillow.agentReviews(i)
+      )
+    );
+  }
+  if (all || enableBooking) {
+    tools.push(
+      tool(
+        "BOOKING_SEARCH",
+        "Scavio Booking.com Search",
+        "Booking.com properties for a destination and stay: live nightly price, review score, star rating, location, room type, deal badges. 25 properties per page. Provide destination or dest_id. Costs 1 credit.",
+        import_zod.z.object({
+          destination: ostr("Destination to search, e.g. 'Paris' (1-200 characters). Required unless dest_id is given."),
+          dest_id: ostr("Numeric Booking.com destination id, as an alternative to destination."),
+          dest_type: ostr("What dest_id refers to. Requires dest_id and is rejected without it, because Booking silently ignores a lone dest_type. Accepted values: 'city', 'region', 'country', 'district', 'landmark', 'airport', 'hotel'."),
+          page: onum("Results page, 1-based. 25 properties per page, 1 credit each."),
+          sort_by: ostr("Result sort order (default 'popularity'). Accepted values: 'popularity', 'price_low', 'price_high', 'stars_high', 'stars_low', 'stars_and_price', 'distance', 'review_score'."),
+          min_price: onum("Minimum price PER NIGHT in `currency`, >= 0. Must not exceed max_price."),
+          max_price: onum("Maximum price PER NIGHT in `currency`, >= 0."),
+          stars: oarrnum("Star ratings to include, each 1-5, 1-5 values, OR'd together (e.g. [4, 5])."),
+          min_review_score: ostr("Minimum guest review score. Only '6', '7', '8' and '9' exist upstream; any other threshold is silently dropped."),
+          property_type: ostrnum("Accommodation type by name, or a raw numeric Booking accommodation-type id (>= 1). Accepted values: 'apartments', 'hostels', 'hotels', 'motels', 'resorts', 'bed_and_breakfasts', 'villas', 'campgrounds', 'vacation_homes', 'lodges', 'homestays'."),
+          free_cancellation: obool("Only properties offering free cancellation."),
+          no_prepayment: obool("Only properties that take no prepayment."),
+          breakfast_included: obool("Only rates that include breakfast."),
+          checkin: ostr("Check-in date, YYYY-MM-DD. Must be sent together with checkout: a lone checkin is ignored and Booking prices a default range of its own."),
+          checkout: ostr("Check-out date, YYYY-MM-DD. Must be later than checkin and sent together with it."),
+          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.")
+        }),
+        (i) => client.booking.search(i)
+      ),
+      tool(
+        "BOOKING_HOTEL",
+        "Scavio Booking.com Hotel",
+        "One Booking.com property in full: rooms and rate plans, facilities, house rules, check-in windows, policies, images, location and review scores, priced for the stay asked for. Chaining the `url` a search row returns is cheaper than a bare slug. Costs 1 credit.",
+        import_zod.z.object({
+          hotel: str("Booking.com property URL or the bare page slug (1-500 characters); query params are discarded."),
+          country_code: ostr("Two-letter country code for the property page (default 'us'). Only consulted for a bare slug, where a wrong one is a real, BILLED 404."),
+          checkin: ostr("Check-in date, YYYY-MM-DD. Must be sent together with checkout; omitting both prices a two-night range Booking chose, echoed back in the response."),
+          checkout: ostr("Check-out date, YYYY-MM-DD. Must be later than checkin and sent together with it."),
+          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.")
+        }),
+        (i) => client.booking.hotel(i)
+      ),
+      tool(
+        "BOOKING_REVIEWS",
+        "Scavio Booking.com Reviews",
+        "Booking.com guest reviews for a property with the score breakdown by category and Booking's own praise/complaint summary. No page param: total_count is the whole review history, count is what this response holds. Costs 1 credit.",
+        import_zod.z.object({
+          hotel: str("Booking.com property URL or the bare page slug (1-500 characters); query params are discarded."),
+          country_code: ostr("Two-letter country code for the property page (default 'us'). Only consulted for a bare slug, where a wrong one is a real, BILLED 404."),
+          checkin: ostr("Check-in date, YYYY-MM-DD. Must be sent together with checkout; it prices the stay the review page is rendered for."),
+          checkout: ostr("Check-out date, YYYY-MM-DD. Must be later than checkin and sent together with it."),
+          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').")
+        }),
+        (i) => client.booking.reviews(i)
+      )
+    );
+  }
+  if (all || enableTripadvisor) {
+    tools.push(
+      tool(
+        "TRIPADVISOR_LOCATIONS",
+        "Scavio Tripadvisor Locations",
+        "START HERE: resolve a place or business NAME to the TripAdvisor geo_id / location_id pair every other TripAdvisor endpoint is keyed by. Up to 20 rows. Costs 2 credits.",
+        import_zod.z.object({
+          query: str("Place or business name to resolve (1-120 characters)."),
+          limit: onum("Rows to return, 1-20 (default 12). Sizes the response only; there is no paging here.")
+        }),
+        (i) => client.tripadvisor.locations(i)
+      ),
+      tool(
+        "TRIPADVISOR_SEARCH",
+        "Scavio Tripadvisor Search",
+        "Restaurants, hotels or attractions in a TripAdvisor geo, TripAdvisor-ranked: rating, review count, price band, address, coordinates, phone, hours, Travelers' Choice badge; each row carries the location_id + geo_id pair. 30 locations per page. Provide geo_id or url. Costs 2 credits.",
+        import_zod.z.object({
+          geo_id: ostr("TripAdvisor geo id (1-500 characters): 30196, g30196, or a URL carrying one. Required unless url is given."),
+          category: ostr("Listing family to search (default 'restaurants'). Accepted values: 'restaurants', 'hotels', 'attractions'."),
+          page: onum("Results page, 1-based. 30 locations per page; a page beyond the last is a 404, not an empty result."),
+          url: ostr("Full tripadvisor.com listing URL (1-500 characters), as an alternative to geo_id; country sites are accepted.")
+        }),
+        (i) => client.tripadvisor.search(i)
+      ),
+      tool(
+        "TRIPADVISOR_LOCATION",
+        "Scavio Tripadvisor Location",
+        "One TripAdvisor location in full: rating, review histogram and per-aspect sub-ratings, city ranking, price band, cuisines, amenities, address, coordinates, contact, photos, and the FIRST PAGE OF REVIEWS. Provide location_id or url. Costs 2 credits.",
+        import_zod.z.object({
+          location_id: ostr("TripAdvisor location id (1-500 characters): 1899234, d1899234, or a full _Review URL. Required unless url is given."),
+          geo_id: ostr("Geo the location sits in; required when location_id is a bare d-id."),
+          category: ostr("Location family (default 'restaurants'); match the location's own type. Accepted values: 'restaurants', 'hotels', 'attractions'."),
+          url: ostr("Full tripadvisor.com _Review URL (1-500 characters), as an alternative to location_id.")
+        }),
+        (i) => client.tripadvisor.location(i)
+      ),
+      tool(
+        "TRIPADVISOR_REVIEWS",
+        "Scavio Tripadvisor Reviews",
+        "A page of TripAdvisor reviews: rating, trip date and type, reviewer home town and contribution count, management response. Page 1 already rides along in location(), so use this to page PAST it; consecutive pages can repeat one review at the boundary, so de-duplicate on review_id. Provide location_id or url. Costs 2 credits.",
+        import_zod.z.object({
+          location_id: ostr("TripAdvisor location id (1-500 characters): 1899234, d1899234, or a full _Review URL. Required unless url is given."),
+          geo_id: ostr("Geo the location sits in; required when location_id is a bare d-id."),
+          category: ostr("Location family (default 'restaurants'). It sets the page size, so it must match the location's own type on any page past the first. Accepted values: 'restaurants', 'hotels', 'attractions'."),
+          url: ostr("Full tripadvisor.com _Review URL (1-500 characters), as an alternative to location_id."),
+          page: onum("Reviews page, 1-based. 15 per page for restaurants, 10 for hotels and attractions; past the last page is a 404.")
+        }),
+        (i) => client.tripadvisor.reviews(i)
+      )
+    );
+  }
+  if (all || enableIndeed) {
+    tools.push(
+      tool(
+        "INDEED_SEARCH",
+        "Scavio Indeed Search",
+        "Indeed job postings: title, employer, rating, location, salary range, job type, benefits, posting age, apply route. 10 postings per page. Provide query or location - a location-only search (every posting in a metro) is valid. Costs 2 credits.",
+        import_zod.z.object({
+          query: ostr("Job title, keywords or employer (1-500 characters). Required unless location is given."),
+          location: ostr("City and state, postal code, state, country, or 'Remote' (1-200 characters). Valid on its own with no query."),
+          page: onum("Results page, 1-based. 10 postings per page, 1 call each."),
+          radius: onum("Search radius in miles around location. Closed set: Indeed IGNORES any other value and returns the unfiltered set. Upstream default 50. Accepted values: 0, 5, 10, 15, 25, 35, 50, 100."),
+          max_age_days: onum("Maximum posting age in days. Closed set: Indeed IGNORES any other value and returns postings of every age. Accepted values: 1, 3, 7, 14."),
+          job_type: ostr("Employment type filter. Accepted values: 'full_time', 'part_time', 'contract', 'temporary', 'internship'."),
+          min_salary: onum("Minimum annual salary, >= 0. Filters on INDEED'S OWN ESTIMATE for the role, not a posted figure, so postings publishing no salary still match."),
+          remote: obool("Remote postings only.")
+        }),
+        (i) => client.indeed.search(i)
+      ),
+      tool(
+        "INDEED_JOB",
+        "Scavio Indeed Job",
+        "One Indeed posting in full: description text and HTML, structured salary, employment types, benefits, geocoded address, employer rating, applicant count, original ATS link. An unknown job key is a real 404 that is still billed. Costs 2 credits.",
+        import_zod.z.object({
+          job_id: str("16-hex Indeed job key, or any indeed.com URL carrying jk= (/viewjob, /rc/clk, /pagead/clk).")
+        }),
+        (i) => client.indeed.job(i)
+      ),
+      tool(
+        "INDEED_COMPANY",
+        "Scavio Indeed Company",
+        "Indeed employer profile: description, industry, HQ, size, revenue, CEO approval, overall and per-category ratings, reported salaries, open roles, locations. An unknown slug is a real 404 that is still billed. Costs 2 credits.",
+        import_zod.z.object({
+          company: str("indeed.com/cmp/<slug> slug or a full profile URL (1-200 characters); slugs are untidy, e.g. 'Tata-Consultancy-Services-(tcs)'.")
+        }),
+        (i) => client.indeed.company(i)
+      ),
+      tool(
+        "INDEED_COMPANY_REVIEWS",
+        "Scavio Indeed Company Reviews",
+        "Indeed employee reviews, 20 per page, with per-category ratings, pros/cons, reviewer job title and location, plus aggregated sentiment and topic/location/job-title breakdowns. Costs 2 credits.",
+        import_zod.z.object({
+          company: str("indeed.com/cmp/<slug> slug or a full profile URL (1-200 characters)."),
+          page: onum("Reviews page, 1-based. 20 reviews per page.")
+        }),
+        (i) => client.indeed.companyReviews(i)
+      )
+    );
+  }
+  if (all || enableAirbnb) {
+    tools.push(
+      tool(
+        "AIRBNB_SEARCH",
+        "Scavio Airbnb Search",
+        "Airbnb stays: stay-total and per-night price with the full discount ledger, rating and review count, bedrooms/beds/baths, coordinates, badges, images, dates_are_defaulted. 18 listings per page; page and cursor are mutually exclusive. Costs 1 credit.",
+        import_zod.z.object({
+          location: str("City, region, ZIP, or a pasted airbnb.com/s/ URL (1-200 characters). An unresolvable location is a 404."),
+          check_in: ostr("Check-in date, YYYY-MM-DD. Must be sent with check_out; omitting both defaults to +30 days and flags dates_are_defaulted in the response."),
+          check_out: ostr("Check-out date, YYYY-MM-DD. Must be later than check_in; defaults to check_in plus 5 nights when omitted."),
+          adults: onum("Adult guests, >= 1."),
+          children: onum("Children aged 2-12, >= 0."),
+          infants: onum("Infants under 2, >= 0."),
+          pets: onum("Pets, >= 0."),
+          min_price: onum("Minimum price for the WHOLE STAY in `currency`, not per night, >= 0. Must not exceed max_price."),
+          max_price: onum("Maximum price for the WHOLE STAY in `currency`, not per night, >= 0."),
+          room_type: ostr("Room type. Validated before the scrape, because an unrecognised value returns the UNFILTERED set under a 200. Accepted values: 'entire_home', 'private_room', 'shared_room', 'hotel_room'."),
+          min_bedrooms: onum("Minimum bedrooms, >= 0."),
+          min_beds: onum("Minimum beds, >= 0."),
+          min_bathrooms: onum("Minimum bathrooms, >= 0."),
+          superhost: obool("Superhost listings only."),
+          instant_book: obool("Instant Book listings only."),
+          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."),
+          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.")
+        }),
+        (i) => client.airbnb.search(i)
+      ),
+      tool(
+        "AIRBNB_LISTING",
+        "Scavio Airbnb Listing",
+        "One Airbnb listing in full: description, property/room type, capacity and room counts, the complete grouped amenity list (including what the place does NOT have), host profile and stats, house rules, cancellation policy, sleeping arrangements, photo tour and the RATING BREAKDOWN. Carries NO nightly price - prices are search-only. Costs 1 credit.",
+        import_zod.z.object({
+          listing_id: str("Airbnb listing id or a full /rooms/ URL (1-500 characters); query params are discarded, since they carry someone else's dates."),
+          check_in: ostr("Check-in date, YYYY-MM-DD. Must be sent with check_out. Does not produce a price: the room page has no nightly rate."),
+          check_out: ostr("Check-out date, YYYY-MM-DD. Must be later than check_in and sent together with it."),
+          adults: onum("Adult guests, >= 1."),
+          children: onum("Children aged 2-12, >= 0."),
+          infants: onum("Infants under 2, >= 0."),
+          pets: onum("Pets, >= 0."),
+          currency: ostr("ISO 4217 currency, 3 letters (default 'USD').")
+        }),
+        (i) => client.airbnb.listing(i)
+      ),
+      tool(
+        "AIRBNB_REVIEWS",
+        "Scavio Airbnb Reviews",
+        "Airbnb review BODIES with per-review rating, date and reviewer name/photo/location, limit/offset paged at up to 50 per call. `count` is the listing's TOTAL review count, `returned` is how many this page holds. The rating breakdown lives on listing(), not here. Costs 1 credit.",
+        import_zod.z.object({
+          listing_id: str("Airbnb listing id or a full /rooms/ URL (1-500 characters)."),
+          currency: ostr("ISO 4217 currency, 3 letters (default 'USD')."),
+          limit: onum("Reviews to return, 1-50 (default 30). Upstream returns a fixed 7 when no explicit limit is sent."),
+          offset: onum("Reviews to skip before this page, >= 0 (default 0).")
+        }),
+        (i) => client.airbnb.reviews(i)
+      )
+    );
+  }
+  if (all || enableGlassdoor) {
+    tools.push(
+      tool(
+        "GLASSDOOR_COMPANIES",
+        "Scavio Glassdoor Companies",
+        "START HERE. Resolve a company NAME to the employer_id every other Glassdoor method is keyed by, ranked by Glassdoor and de-duplicated. Costs 1 credit.",
+        import_zod.z.object({
+          query: str("Company name to resolve (1-120 characters).")
+        }),
+        (i) => client.glassdoor.companies(i)
+      ),
+      tool(
+        "GLASSDOOR_COMPANY",
+        "Scavio Glassdoor Company",
+        "Glassdoor employer profile: description, mission, industry, sector, HQ, size and revenue bands, stock symbol, year founded, overall and per-category ratings, star distribution, CEO approval, awards, FAQ and the five server-rendered reviews. Also returns reviews_url and salaries_url, which reviews() and salaries() accept as url to save a fetch. Provide employer_id or url. Costs 1 credit.",
+        import_zod.z.object({
+          employer_id: ostr("Glassdoor employer id (1-50 characters) in any form Glassdoor writes it: '1699', 'E1699' or 'IE1699'. Must be a STRING - a JSON number is rejected."),
+          company: ostr("Employer name as it appears in a Glassdoor slug (1-200 characters). COSMETIC: the profile resolves on employer_id alone, it is ignored entirely 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): /Overview/, /Reviews/ or /Salary/. A non-glassdoor.com host is rejected.")
+        }),
+        (i) => client.glassdoor.company(i)
+      ),
+      tool(
+        "GLASSDOOR_REVIEWS",
+        "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."),
+          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'."),
+          employment_status: ostr("Restrict to one kind of employment. Closed enum for the same reason as category; FREELANCE is deliberately absent because it was never confirmed to change the result set. Accepted values: 'full_time', 'part_time', 'contract', 'intern'.")
+        }),
+        (i) => client.glassdoor.reviews(i)
+      ),
+      tool(
+        "GLASSDOOR_SALARIES",
+        "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."),
+          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.")
+        }),
+        (i) => client.glassdoor.salaries(i)
+      )
+    );
+  }
+  if (all || enableYelp) {
+    tools.push(
+      tool(
+        "YELP_SEARCH",
+        "Scavio Yelp Search",
+        "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."),
+          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."),
+          open_now: obool("Only businesses open at the moment of the request."),
+          attributes: oarrstr("Raw Yelp filter aliases, max 20, each 1-100 characters ('RestaurantsDelivery', 'GoodForKids', 'WheelchairAccessible'). A deliberate PASSTHROUGH, not an enum - Yelp's vocabulary runs to ~117 values per vertical and an alias it does not know is ignored upstream, returning unfiltered results."),
+          url: ostr("A full yelp.com/search URL (1-1000 characters) as an alternative to term + location; the query, offset and sort are read out of it and the URL is rebuilt.")
+        }),
+        (i) => client.yelp.search(i)
+      ),
+      tool(
+        "YELP_BUSINESS",
+        "Scavio Yelp Business",
+        "One business in full: rating and per-star histogram, review count, price band, categories, address and coordinates, phone, website and menu links, hours and holidays, amenities, photos and videos, popular items, health inspections, Q&A, licences and claim status - plus the first page of reviews at no extra cost. Provide business_id or url. Costs 2 credits.",
+        import_zod.z.object({
+          business_id: ostr("A Yelp business alias ('desnudo-coffee-austin-2'), its opaque encid, or any yelp.com/biz URL carrying one (1-500 characters). Search rows return both id forms."),
+          url: ostr("A full yelp.com/biz URL (1-1000 characters) as an alternative to business_id.")
+        }),
+        (i) => client.yelp.business(i)
+      ),
+      tool(
+        "YELP_REVIEWS",
+        "Scavio Yelp Reviews",
+        "A page of reviews: rating, full text, language, author profile and expertise counts, attached photos, reaction counts and owner response. 10 per page. PAGE 1 IS REDUNDANT - it re-fetches the document business() already returned - so start at page 2. Provide business_id or url. Costs 2 credits.",
+        import_zod.z.object({
+          business_id: ostr("A Yelp business alias ('desnudo-coffee-austin-2'), its opaque encid, or any yelp.com/biz URL carrying one (1-500 characters)."),
+          url: ostr("A full yelp.com/biz URL (1-1000 characters) as an alternative to business_id."),
+          page: onum("Reviews page, 1-based, 10 per page. Page 1 duplicates the reviews business() already returned and costs another 2 credits - start at 2. A page past the last review is a 404, not an empty result."),
+          sort: ostr("Review ordering (upstream default 'relevance'). Closed enum: Yelp IGNORES an unrecognised value and serves default ranking under a billed 200. Accepted values: 'relevance', 'newest', 'oldest', 'rating_high', 'rating_low', 'elites'."),
+          rating: onum("Only reviews at this star rating, 1-5. Changes filtered_review_count on the response, not review_count. Accepted values: 1, 2, 3, 4, 5.")
+        }),
+        (i) => client.yelp.reviews(i)
+      )
+    );
+  }
+  if (all || enableAppStore) {
+    tools.push(
+      tool(
+        "APP_STORE_SEARCH",
+        "Scavio App Store Search",
+        "Search the App Store and get up to 200 fully-shaped app rows - the same 43-field row as app() - so a search doubles as a bulk metadata fetch and as a publisher lookup. NO PAGINATION: raise limit, there is no second page. Costs 1 credit.",
+        import_zod.z.object({
+          term: str("What to search for (1-500 characters). Apple matches an app name, a keyword OR a publisher name, so searching a developer returns their catalogue."),
+          limit: onum("Apps to return, 1-200 (default 25). The ONLY lever on result volume: the search API has no pagination and every offset spelling is silently ignored."),
+          country: ostr("Two-letter ISO storefront code (default 'us'); decides price, currency, localised title and whether the app is sold there at all. Anything that is not exactly two letters is rejected with a free 400."),
+          entity: ostr("Which catalogue to search: iPhone/iPad apps ('software', the default), iPad apps, or Mac App Store apps. These are separate stores, not a filter - Mac rows carry no iPad/Apple TV screenshots, advisories, features, supported devices or Game Center flag, returning them empty rather than absent. Accepted values: 'software', 'ipad_software', 'mac_software'."),
+          lang: ostr("Listing text language as a five-letter code ('en_us', 'ja_jp'); any other shape is rejected. Independent of country: the storefront sets the price, this sets the words.")
+        }),
+        (i) => client.appStore.search(i)
+      ),
+      tool(
+        "APP_STORE_APP",
+        "Scavio App Store App",
+        "Full App Store listing: title, description, developer and seller identity, price and currency, all-time and current-version ratings, version and release notes, genres, content rating and advisories, icons at three sizes, screenshots, download size, minimum OS, languages, supported devices and the Game Center and VPP flags. Costs 1 credit.",
+        import_zod.z.object({
+          app_id: str("App Store id - the digits after 'id' in an apps.apple.com URL - or the app's bundle id ('notion.id', 'com.burbn.instagram'); both resolve to the identical payload. 1-255 characters matching ^[A-Za-z0-9][A-Za-z0-9._-]*$, so a pasted apps.apple.com URL is rejected with a free 400. An id Apple cannot resolve is a billed 404."),
+          country: ostr("Two-letter ISO storefront code (default 'us'); decides price, currency, localised title and whether the app is sold there at all. Anything that is not exactly two letters is rejected with a free 400.")
+        }),
+        (i) => client.appStore.app(i)
+      ),
+      tool(
+        "APP_STORE_REVIEWS",
+        "Scavio App Store Reviews",
+        "A page of App Store reviews: star rating, title, full text, author and the APP VERSION the review was written against. 50 per page, hard-stopped at page 10 - 500 reviews per storefront is Apple's anonymous ceiling. This endpoint cannot 404: an unknown id and a real app with no reviews return the same empty feed. Costs 1 credit.",
+        import_zod.z.object({
+          app_id: str("App Store id, NUMERIC ONLY - unlike app(), the reviews feed has no bundle-id form."),
+          country: ostr("Two-letter ISO storefront code (default 'us'). Anything that is not exactly two letters is rejected with a free 400. Ask a different country to reach past the 500-review ceiling."),
+          page: onum("Reviews page, 1-10, 50 reviews each (default 1). Apple hard-stops at page 10."),
+          sort: ostr("Review ordering (default 'most_recent'). The choice decides whether the vote fields mean anything: under most_recent almost every review is too new to have been voted on and returns zeroes, while most_helpful returns them densely populated.")
+        }),
+        (i) => client.appStore.reviews(i)
+      )
+    );
+  }
+  if (all || enableGooglePlay) {
+    tools.push(
+      tool(
+        "GOOGLE_PLAY_SEARCH",
+        "Scavio Google Play Search",
+        "Ranked Google Play apps: package name, title, developer, rating, install count, price and IAP range, content rating, icon and screenshots. A branded query returns the hero card as result 1 in the same row shape, plus Play's related-query rail. NO PAGINATION - one shelf of about 30 apps. Costs 2 credits.",
+        import_zod.z.object({
+          query: str("What to search the store for (1-200 characters): an app name, a publisher, or a category phrase. Apps only - games are folded into the apps vertical, but books and films use a different card shape and are not covered."),
+          hl: ostr("UI language, 2-20 characters (default 'en'). Changes the STOREFRONT, not only the strings: at hl=pt-BR the title, description, install formatting and content rating all move with it. Play silently falls back to English on a value it does not serve."),
+          gl: ostr("Country code, 2-10 characters (default 'us'), deciding which storefront's price and availability are returned. Play silently falls back to the US storefront on a country it does not serve.")
+        }),
+        (i) => client.googlePlay.search(i)
+      ),
+      tool(
+        "GOOGLE_PLAY_APP",
+        "Scavio Google Play App",
+        "Full Google Play store listing: installs including the REAL count Play publishes but never renders, rating and star histogram, description, developer identity and legal contact, price and IAPs, categories and gameplay tags, screenshots and trailer, version and Android requirement, release and update dates, changelog, the full permission tree, the Data safety table, the 20 server-rendered reviews and the similar-apps and more-by-developer rails. Costs 2 credits.",
+        import_zod.z.object({
+          app_id: str("Android package name ('com.spotify.music') or any play.google.com URL carrying one in its id param (1-500 characters)."),
+          hl: ostr("UI language, 2-20 characters (default 'en'). Changes the STOREFRONT, not only the strings: title, description, install formatting and content rating all move with it. Play silently falls back to English on a value it does not serve."),
+          gl: ostr("Country code, 2-10 characters (default 'us'), deciding which storefront's price and availability are returned. Play silently falls back to the US storefront on a country it does not serve.")
+        }),
+        (i) => client.googlePlay.app(i)
+      ),
+      tool(
+        "GOOGLE_PLAY_REVIEWS",
+        "Scavio Google Play Reviews",
+        "A page of Google Play reviews: star score, full text, author, thumbs-up count, developer reply and the APP VERSION the reviewer was running. Paged by cursor, up to 200 per call. app() already returns the 20 reviews Play server-renders; use this to page past them or sort differently. Costs 2 credits.",
+        import_zod.z.object({
+          app_id: str("Android package name ('com.spotify.music') or any play.google.com URL carrying one in its id param (1-500 characters)."),
+          sort: ostr("Review ordering (default 'newest'). Closed enum. The cursor encodes the sort, so keep this identical when paging. Accepted values: 'relevance', 'newest', 'rating'."),
+          count: onum("Reviews to return, 1-200 (default 50); 200 is our cap, not Play's. Play honours more, but a single page that large is megabytes for one credit - page with cursor instead."),
+          cursor: ostr("Continuation token from a prior response's next_cursor (1-4000 characters). Opaque and SINGLE-USE, and it encodes the sort as well as the position - send it back with the SAME sort it came from. A cursor past the last review is a 404, not an empty page."),
+          hl: ostr("UI language, 2-20 characters (default 'en'). Changes the STOREFRONT, not only the strings. Play silently falls back to English on a value it does not serve."),
+          gl: ostr("Country code, 2-10 characters (default 'us'), deciding which storefront's price and availability are returned. Play silently falls back to the US storefront on a country it does not serve.")
+        }),
+        (i) => client.googlePlay.reviews(i)
+      )
+    );
+  }
+  if (all || enableSec) {
+    tools.push(
+      tool(
+        "SEC_LOOKUP",
+        "Scavio SEC Lookup",
+        "START HERE. Resolve a company name or ticker (AAPL) to the CIK (0000320193) every other SEC EDGAR endpoint is keyed by. Up to 100 rows, tiered by match quality. Costs 1 credit.",
+        import_zod.z.object({
+          query: str("Ticker ('AAPL', 'BRK.B'), company name, or a fragment of one (1-200 characters); each row carries its match tier as 'match'."),
+          limit: onum("Rows to return, 1-100. Defaults to 10. Sizes the response; it is not a page param."),
+          exchange: ostr("Restrict to one listing venue; matched case-insensitively, so 'Nasdaq' also works. Filers the SEC lists with no exchange at all are excluded by any value. Accepted values: 'NASDAQ', 'NYSE', 'OTC', 'CBOE'.")
+        }),
+        (i) => client.sec.lookup(i)
+      ),
+      tool(
+        "SEC_COMPANY",
+        "Scavio SEC Company",
+        "SEC filer profile: legal and former names, SIC industry, filer category, EIN, LEI, state of incorporation, fiscal year end, addresses, every ticker with its exchange, and a preview of its 10 most recent filings. Provide cik or ticker. Costs 1 credit.",
+        import_zod.z.object({
+          cik: ostr("Filer CIK in any spelling (1-20 characters): 320193, 0000320193 or CIK0000320193. A ticker is accepted here too."),
+          ticker: ostr("Ticker symbol (1-20 characters), dotted or dashed (BRK.B / BRK-B). Wins over cik when both are given.")
+        }),
+        (i) => client.sec.company(i)
+      ),
+      tool(
+        "SEC_FILINGS",
+        "Scavio SEC Filings",
+        "A page of one filer's filings: accession number, form and root form, filing and period dates, 8-K item codes, direct links to the primary document, filing index and attachment directory. Up to 500 per page. Provide cik or ticker. Costs 1 credit.",
+        import_zod.z.object({
+          cik: ostr("Filer CIK, zero-padded or bare (1-20 characters). A ticker is accepted here too."),
+          ticker: ostr("Ticker symbol (1-20 characters), as an alternative to cik."),
+          form: ostrarr("Form types to keep: '10-K', ['10-K', '10-Q'] or the comma-joined '10-K,8-K'; each value 1-50 characters, at most 25 values. Matched against the form AND its root form, so 10-K also returns 10-K/A amendments; ask for '10-K/A' to get only amendments."),
+          date_from: ostr("Earliest filing date, inclusive (YYYY-MM-DD)."),
+          date_to: ostr("Latest filing date, inclusive (YYYY-MM-DD)."),
+          page: onum("Results page, 1-based; page size is whatever limit is set to. No upper bound."),
+          limit: onum("Filings per page, 1-500. Defaults to 50."),
+          include_history: obool("Also fetch the archived filing history beyond EDGAR's 'recent' block, which is not a fixed window (a decade for a quiet filer, about a year for a prolific one). Off by default; at most 10 archived shards are fetched, history_truncated says when a filer had more, and it is still 1 credit.")
+        }),
+        (i) => client.sec.filings(i)
+      ),
+      tool(
+        "SEC_CONCEPT",
+        "Scavio SEC Concept",
+        "Every value a filer reported for one XBRL concept, newest period first, with the form and filing each number came from. Restatements are kept, not collapsed. Up to 2000 rows. Provide cik or ticker. Costs 1 credit.",
+        import_zod.z.object({
+          concept: str("XBRL concept tag, CASE-SENSITIVE (1-120 characters, ^[A-Za-z][A-Za-z0-9]*$): 'NetIncomeLoss' matches, 'netincomeloss' is a 404 upstream. Use facts() to list what a filer actually reports."),
+          cik: ostr("Filer CIK, zero-padded or bare (1-20 characters). A ticker is accepted here too."),
+          ticker: ostr("Ticker symbol (1-20 characters), as an alternative to cik."),
+          taxonomy: ostr("Reporting taxonomy (1-40 characters, ^[A-Za-z][A-Za-z0-9-]*$): us-gaap, dei, ifrs-full or srt. Defaults to 'us-gaap'."),
+          unit: ostr("Unit of measure to keep (1-40 characters), e.g. 'USD' vs 'USD/shares'."),
+          form: ostr("Form to keep (1-50 characters). EXACT match here, unlike filings(), so '10-K' excludes 10-K/A."),
+          limit: onum("Rows to return, 1-2000. Defaults to 250. Sizes the response; it is not a page param.")
+        }),
+        (i) => client.sec.concept(i)
+      ),
+      tool(
+        "SEC_FACTS",
+        "Scavio SEC Facts",
+        "The index of every XBRL concept a filer reports - tag, label, description, units and most recent value - across us-gaap, dei and any other taxonomy it uses. This is how you find what to ask concept() for. Up to 2000 rows. Provide cik or ticker. Costs 1 credit.",
+        import_zod.z.object({
+          cik: ostr("Filer CIK, zero-padded or bare (1-20 characters). A ticker is accepted here too."),
+          ticker: ostr("Ticker symbol (1-20 characters), as an alternative to cik."),
+          taxonomy: ostr("Restrict to one taxonomy (1-40 characters), e.g. 'us-gaap' or 'dei'."),
+          query: ostr("Case-insensitive substring matched against the tag name and label (1-200 characters)."),
+          limit: onum("Rows to return, 1-2000. Defaults to 250. Sizes the response; it is not a page param.")
+        }),
+        (i) => client.sec.facts(i)
+      ),
+      tool(
+        "SEC_SEARCH",
+        "Scavio SEC Search",
+        "EDGAR full-text search, coverage starting 2001: each hit is the matching DOCUMENT with its URL, form, filing date and filer identity, plus facets by company, form, industry and state. 100 documents per page, last page is 100. Costs 1 credit.",
+        import_zod.z.object({
+          query: ostr("Full-text query over filing documents (1-500 characters); a quoted phrase is matched exactly, bare words as a bag of terms. Optional - a cik, ticker, form or date filter on its own is a valid search."),
+          cik: ostrarr("Restrict to one or more filers by CIK: a single value, a list, or a comma-joined string; each 1-20 characters, at most 25 values. Tickers are accepted here too."),
+          ticker: ostrarr("Restrict to one or more filers by ticker symbol: a single value, a list, or a comma-joined string; each 1-20 characters, at most 25 values."),
+          form: ostrarr("Form types to keep: '8-K', ['10-K', '10-Q'] or the comma-joined '10-K,10-Q'; each 1-50 characters, at most 25 values."),
+          date_from: ostr("Earliest filing date, inclusive (YYYY-MM-DD). Full-text coverage starts in 2001."),
+          date_to: ostr("Latest filing date, inclusive (YYYY-MM-DD)."),
+          location: ostrarr("Filer business-address locations as EDGAR's own 2-character codes (CA, NY, and its alphanumeric codes for foreign jurisdictions): a single value, a list, or a comma-joined string; at most 25 values."),
+          sort: ostr("Result ordering. Defaults to the index's own relevance ranking. Accepted values: 'relevance', 'newest', 'oldest'."),
+          page: onum("Results page, 1-based, 1-100, 100 documents per page. The SEC's index refuses a result window past 10,000, so 100 is the last page for any query.")
+        }),
+        (i) => client.sec.search(i)
+      )
+    );
+  }
+  if (all || enableRedfin) {
+    tools.push(
+      tool(
+        "REDFIN_SEARCH",
+        "Scavio Redfin Search",
+        "Redfin listings: price, price per sqft, beds, baths, living area, lot size, year built, coordinates, listing remarks and full photo galleries, for sale, sold or for rent. Up to 350 per page. Provide location, or region_id together with region_type. Costs 1 credit.",
+        import_zod.z.object({
+          location: ostr("A redfin.com region URL (/city/, /neighborhood/, /county/, /zipcode/) or a bare 5-digit ZIP (1-500 characters). CITY NAMES ARE NOT ACCEPTED - Redfin's own name lookup is blocked to us; use region_id + region_type instead."),
+          region_id: onum("Redfin internal region id (>= 1), used together with region_type. NOT a ZIP code - the two are different number spaces and a ZIP here resolves to another city rather than failing."),
+          region_type: onum("Region kind that region_id belongs to: 1 neighborhood, 2 ZIP, 5 county, 6 city. Must be sent together with region_id or both are ignored in favour of location."),
+          listing_status: ostr("Market to search. Defaults to 'for_sale'. Accepted values: 'for_sale', 'sold', 'for_rent'."),
+          sold_within_days: onum("Sold within the last N days (>= 1). REJECTED unless listing_status='sold', where it defaults to 90."),
+          page: onum("Results page, 1-based; page size is whatever limit is set to. No upper bound."),
+          limit: onum("Listings per page, 1-350. Defaults to 100."),
+          sort: ostr("Result sort order. Defaults to 'recommended', Redfin's own ranking. Accepted values: 'recommended', 'price_low', 'price_high', 'newest', 'oldest', 'sqft_low', 'sqft_high', 'price_per_sqft_low', 'price_per_sqft_high'."),
+          min_price: onum("Minimum price, inclusive (>= 0). Monthly rent when listing_status='for_rent'."),
+          max_price: onum("Maximum price, inclusive (>= 0). Monthly rent when listing_status='for_rent'."),
+          beds_min: onum("Minimum bedrooms (whole number >= 0); fractional values are rejected."),
+          beds_max: onum("Maximum bedrooms (whole number >= 0); fractional values are rejected."),
+          baths_min: onum("Minimum bathrooms (whole number >= 0). WHOLE BATHS ONLY - 1.5 is rejected rather than silently truncated to 1. There is no baths_max."),
+          sqft_min: onum("Minimum living area in square feet (whole number >= 0)."),
+          sqft_max: onum("Maximum living area in square feet (whole number >= 0)."),
+          lot_size_min: onum("Minimum lot size in square feet (whole number >= 0). There is no lot_size_max."),
+          year_built_min: onum("Earliest year built (whole number >= 0)."),
+          year_built_max: onum("Latest year built (whole number >= 0)."),
+          max_hoa: onum("Maximum monthly HOA fee in dollars (>= 0)."),
+          property_type: ostr("Restrict to one property type. Accepted values: 'house', 'condo', 'townhouse', 'multi_family', 'land', 'other', 'co_op'."),
+          has_pool: obool("Only listings with a pool."),
+          max_days_on_market: onum("Listed at most N days ago (whole number >= 0). Cannot be combined with min_days_on_market - Redfin expresses both bounds through one param."),
+          min_days_on_market: onum("Listed at least N days ago (whole number >= 0). Cannot be combined with max_days_on_market.")
+        }),
+        (i) => client.redfin.search(i)
+      ),
+      tool(
+        "REDFIN_PROPERTY",
+        "Scavio Redfin Property",
+        "One Redfin listing in full: price, Redfin Estimate and rental estimate, complete MLS fact sheet, price and tax history, listing agents, open houses, schools, climate risk, walkability, sun exposure, monthly weather, permits, zoning, comparable sales and photos. Costs 1 credit.",
+        import_zod.z.object({
+          property_id: str("Redfin property id, or any redfin.com listing URL carrying one (1-500 characters).")
+        }),
+        (i) => client.redfin.property(i)
+      ),
+      tool(
+        "REDFIN_MARKET",
+        "Scavio Redfin Market",
+        "Redfin housing-market stats for a region: median list and sale price, price per sqft, sale-to-list ratio, average offers and days on market, YoY movement, 0-100 compete score, live inventory by property type and by bedroom count, and Redfin agent presence. Provide location, or region_id together with region_type. Costs 1 credit.",
+        import_zod.z.object({
+          location: ostr("A redfin.com region URL (/city/, /neighborhood/, /county/, /zipcode/) or a bare 5-digit ZIP (1-500 characters). City names are not accepted."),
+          region_id: onum("Redfin internal region id (>= 1), used together with region_type. Not a ZIP code."),
+          region_type: onum("Region kind that region_id belongs to: 1 neighborhood, 2 ZIP, 5 county, 6 city. Must be sent together with region_id or both are ignored in favour of location.")
+        }),
+        (i) => client.redfin.market(i)
+      )
+    );
+  }
+  if (all || enableCompaniesHouse) {
+    tools.push(
+      tool(
+        "COMPANIES_HOUSE_SEARCH",
+        "Scavio Companies House Search",
+        "START HERE. Search the UK register by name and get the company_number every other Companies House endpoint is keyed by, plus status, incorporation or dissolution date, registered office and matched former names. 20 per page, last page is 50. Costs 1 credit.",
+        import_zod.z.object({
+          query: str("Company name or fragment (1-200 characters, non-blank). Matches CURRENT AND FORMER names."),
+          page: onum("Results page, 1-based, 1-50, 20 results per page. Defaults to 1. The register serves only a 1000-result window per term whatever hit count it prints, and answers page 51 with HTTP 416.")
+        }),
+        (i) => client.companiesHouse.search(i)
+      ),
+      tool(
+        "COMPANIES_HOUSE_COMPANY",
+        "Scavio Companies House Company",
+        "Full UK register entry: status, type, incorporation and dissolution dates, registered office, SIC codes, previous names, accounts and confirmation-statement due dates with overdue flags, and whether it has charges, insolvency history, officers or UK establishments. Costs 1 credit.",
+        import_zod.z.object({
+          company_number: str("UK company number (1-20 characters), zero-padded and upper-cased for you, so '445790' and 'sc090312' both work. Registry prefixes supported: SC, NI, OC, SO, NC, FC, BR, CE.")
+        }),
+        (i) => client.companiesHouse.company(i)
+      ),
+      tool(
+        "COMPANIES_HOUSE_OFFICERS",
+        "Scavio Companies House Officers",
+        "UK company officers, current and resigned, 35 per page: name, role, appointment and resignation dates, correspondence address, nationality, country of residence, month-and-year date of birth and identity-verification status. Costs 1 credit.",
+        import_zod.z.object({
+          company_number: str("UK company number (1-20 characters), zero-padded and upper-cased for you."),
+          page: onum("Results page, 1-based, 35 per page. Defaults to 1. No upper bound: past the last page the register answers an ordinary 200 with an empty list, identical to a company with no officers.")
+        }),
+        (i) => client.companiesHouse.officers(i)
+      ),
+      tool(
+        "COMPANIES_HOUSE_FILING_HISTORY",
+        "Scavio Companies House Filing History",
+        "UK filings, most recent first: date, filing type code (AA, CS01, SH03), description, register annotations and child documents, and a link to the filed PDF with its page count. A filing the register has not finished processing carries a processing_note instead of a document. Costs 1 credit.",
+        import_zod.z.object({
+          company_number: str("UK company number (1-20 characters), zero-padded and upper-cased for you."),
+          page: onum("Results page, 1-based. Defaults to 1. No upper bound: past the last page the register answers an ordinary 200 with an empty list.")
+        }),
+        (i) => client.companiesHouse.filingHistory(i)
+      )
+    );
+  }
+  if (all || enableG2) {
+    tools.push(
+      tool(
+        "G2_SEARCH",
+        "Scavio G2 Search",
+        "Search G2, the B2B software review site, for products: star rating, review count, vendor, categories, seller description and logo, with product_id and slug on every row. Up to 100 results per page (server default 20) and page-paginated; total_results is G2's Products-tab headline and caps at 10000, while total_by_type splits the query across products, sellers, categories and discussions. Provide query or url. Costs 5 credits.",
+        import_zod.z.object({
+          query: ostr("Search term (1-200 characters). Provide this or url."),
+          page: onum("1-based page number; page size follows limit (server default 20). G2 keeps paginating well past its own widget's page links."),
+          limit: onum("Results per page (1-100; server default 20). The 100 ceiling is ours, to keep a single request inside the 60s deadline; G2 itself paginates at any size."),
+          sort: ostr("Result sort order (server default 'relevance'). Closed enum: G2 silently accepts an unknown sort and answers 200 with an unstated ordering. Accepted values: 'relevance', 'popular', 'alphabetical', 'rating'."),
+          rating: onum("Only products at or above this star rating (1-5, sent as an integer). Omit for no rating floor. Accepted values: 1, 2, 3, 4, 5."),
+          url: ostr("Full g2.com/search URL, as an alternative to query (1-1000 characters; the host is checked by the transport).")
+        }),
+        (i) => client.g2.search(i)
+      ),
+      tool(
+        "G2_PRODUCT",
+        "Scavio G2 Product",
+        "Full G2 product profile: rating with per-star histogram, review count, vendor, description and seller website, pricing editions with parsed amounts, feature groups, categories and breadcrumbs, supported languages, integrations, alternatives, head-to-head comparisons, media, community discussions and G2's AI-derived pros and cons. Carries NO review text at all -- G2 loads review bodies in a separate frame, so call reviews() for those. Provide product_id or url. Costs 5 credits.",
+        import_zod.z.object({
+          product_id: ostr("G2 product slug ('notion') or the numeric G2 id ('82623') as a string (1-200 characters); both resolve on the same upstream path."),
+          url: ostr("Full g2.com product URL, as an alternative to product_id (1-1000 characters).")
+        }),
+        (i) => client.g2.product(i)
+      ),
+      tool(
+        "G2_REVIEWS",
+        "Scavio G2 Reviews",
+        "A page of G2 reviews: rating, title, likes and dislikes, problems solved, reviewer job title, industry and company size, validated and incentivized flags -- plus what the profile page has no form of: exact per-star counts, pros and cons with per-theme counts, and company-size, role, industry, region and category facets with counts. Fixed at 10 reviews per page and paginates well past the 10 pages G2's own widget links to. Provide product_id or url. Costs 5 credits.",
+        import_zod.z.object({
+          product_id: ostr("G2 product slug or numeric G2 id as a string (1-200 characters)."),
+          url: ostr("Full g2.com reviews URL, as an alternative to product_id (1-1000 characters)."),
+          page: onum("1-based page number; fixed at 10 reviews per page."),
+          sort: ostr("Review sort order (server default 'relevance'). Closed enum: an unknown sort is silently accepted upstream and never runs. Accepted values: 'relevance', 'newest', 'most_helpful', 'rating_high', 'rating_low'."),
+          rating: onum("Only reviews in this star bucket (1-5, sent as an integer). Buckets are half- star-inclusive: 1 returns 0, 0.5 and 1-star reviews. Accepted values: 1, 2, 3, 4, 5."),
+          company_size: ostr("Reviewer company size: small_business is 50 employees or fewer, mid_market 51-1000, enterprise over 1000. Closed enum -- an unknown value matches nothing and returns a billed 'Reviews (0)'."),
+          role: ostr("Reviewer role. Closed enum -- an unknown value matches nothing rather than erroring. Accepted values: 'user', 'administrator', 'executive_sponsor', 'internal_consultant', 'consultant', 'agency', 'industry_analyst'."),
+          region: ostr("Reviewer region. Closed enum -- an unknown value matches nothing rather than erroring. Accepted values: 'north_america', 'europe', 'asia', 'latin_america', 'anz', 'middle_east', 'africa'."),
+          query: ostr("Full-text search within this product's reviews (1-200 characters); narrows the review list AND every facet count.")
+        }),
+        (i) => client.g2.reviews(i)
+      )
+    );
+  }
+  if (all || enableCapterra) {
+    tools.push(
+      tool(
+        "CAPTERRA_SEARCH",
+        "Scavio Capterra Search",
+        "Search Capterra, the B2B software review site: 20 ranked products with name, vendor description, rating, review count, logo and paid-placement flag, each row carrying product_id and slug. The result set is fixed at 20 and does NOT paginate -- Capterra serves identical rows for page 2, so there is deliberately no page parameter. Provide query or url. Costs 2 credits.",
+        import_zod.z.object({
+          query: ostr("Search term (1-200 characters). Required in practice: a term-less Capterra search serves a fixed popular-products list unrelated to the caller."),
+          url: ostr("Full capterra.com search URL, as an alternative to query (1-1000 characters; the transport also accepts capterra.co.uk and capterra.com.br hosts).")
+        }),
+        (i) => client.capterra.search(i)
+      ),
+      tool(
+        "CAPTERRA_PRODUCT",
+        "Scavio Capterra Product",
+        "Full Capterra profile: rating with per-star histogram and the four scored criteria, likelihood to recommend, review sentiment and topics, the complete pricing table with every plan and its features, every rated feature and integration, AI-derived pros and cons with the quoted review, FAQs, screenshots, badges and awards, competitor comparisons and alternatives, and the buyer profile by company size, industry and job function -- PLUS the 25 most recent reviews at no extra cost. vendor is always null here: Capterra does not publish it as structured data on the product page. Provide product_id or url. Costs 2 credits.",
+        import_zod.z.object({
+          product_id: ostr("The number in a Capterra product path such as /p/186596/Notion/ (1-50 characters). Must be a STRING -- a JSON number is rejected."),
+          slug: ostr("Product slug (1-200 characters). Cosmetic on this endpoint -- a wrong slug still returns the right profile -- but load-bearing on reviews()."),
+          url: ostr("Full Capterra product URL, as an alternative to product_id (1-1000 characters).")
+        }),
+        (i) => client.capterra.product(i)
+      ),
+      tool(
+        "CAPTERRA_REVIEWS",
+        "Scavio Capterra Reviews",
+        "A page of Capterra reviews: overall score plus five per-criterion scores, title, pros, cons, advice, usage duration, incentivized flag, alternatives considered and what they switched from, reviewer job title, industry and company size, and the vendor response -- plus a competitor list richer than the profile's, each alternative with its own rating histogram and starting price. 25 reviews per page, capped at page 100. Page 1 already rides along inside product(), so use this to page past it. Provide product_id or url. Costs 2 credits.",
+        import_zod.z.object({
+          product_id: ostr("Capterra product id as a string (1-50 characters)."),
+          slug: ostr("Product slug (1-200 characters). LOAD-BEARING here: it is case-sensitive upstream and a wrong one silently serves page one under a billed 200. Pass back the slug from search() or product()."),
+          url: ostr("Full Capterra reviews URL, as an alternative to product_id (1-1000 characters). Passing back reviews_url from product() is the reliable way to page."),
+          page: onum("1-based page number (1-100); 25 reviews per page. 100 is a hard cap whatever the review count says -- past it Capterra answers 200 with page one.")
+        }),
+        (i) => client.capterra.reviews(i)
+      )
+    );
+  }
+  if (all || enableGoogleAds) {
+    tools.push(
+      tool(
+        "GOOGLE_ADS_ADVERTISERS",
+        "Scavio Google Ads Advertisers",
+        "Resolve a brand name or domain to the advertiser_id that search() and creative() are keyed by. Returns two row kinds in one list: 'advertiser' rows carrying the id, verified name, verification country and total ad count as a range, and 'domain' rows carrying a website. A name query returns both kinds; a domain-shaped query returns domains only. Autocomplete-backed, roughly 20 rows per arm, and it does not paginate. Costs 1 credit.",
+        import_zod.z.object({
+          query: str("Brand name or domain to resolve (1-200 characters)."),
+          region: ostr("ISO 3166-1 alpha-2 country ('US', 'GB', 'DE') or a Google geo criteria id as a string (2-12 characters). Default: no region filter."),
+          limit: onum("Rows per arm (1-20; server default 10). Advertisers and domains are capped separately, so a name query can return up to twice this many rows.")
+        }),
+        (i) => client.googleAds.advertisers(i)
+      ),
+      tool(
+        "GOOGLE_ADS_SEARCH",
+        "Scavio Google Ads Search",
+        "Every ad Google Ads Transparency holds for one advertiser: the creative (archived image, rich-media bundle, Google's renderer link, dimensions), advertiser id and name, format, first and last seen dates and days actually run, plus total_ads_min and total_ads_max -- Google publishes the advertiser's ad total as a range, never an exact figure. Up to 100 ads per page (server default 40); paginate by sending next_cursor back as cursor alongside the SAME filters. Provide domain or advertiser_id. Costs 1 credit.",
+        import_zod.z.object({
+          domain: ostr("Advertiser website (1-253 characters): bare host, www host or full URL, reduced to the registrable host. The only way to get `domain` back on each row."),
+          advertiser_id: ostr("Google advertiser id, e.g. 'AR16735076323512287233' (3-40 characters). The shape is checked before any request, so a typo costs no credits. Querying by id drops `domain` from every row."),
+          region: ostr("ISO 3166-1 alpha-2 country ('US', 'GB', 'DE') or a Google geo criteria id as a string (2-12 characters). Scopes the deep links on every row, and the same advertiser can share zero creatives between two countries. Default: worldwide."),
+          format: ostr("Creative format. The three sets are disjoint -- an advertiser's text, image and video ads share no creatives. Default: all formats."),
+          platform: ostr("Google surface the ad ran on. Default: all surfaces. Accepted values: 'play', 'maps', 'search', 'shopping', 'youtube'."),
+          topic: ostr("Ad topic (server default 'all'). Accepted values: 'all', 'political'."),
+          limit: onum("Ads per page (1-100; server default 40). 100 is a hard upstream ceiling, not our policy: Google answers a larger request with zero rows rather than an error."),
+          cursor: ostr("next_cursor from the previous response (1-4000 characters), 100 ads per page. Re-send the same filters alongside it; next_cursor is null once exhausted.")
+        }),
+        (i) => client.googleAds.search(i)
+      ),
+      tool(
+        "GOOGLE_ADS_CREATIVE",
+        "Scavio Google Ads Creative",
+        "One creative in full, and the only endpoint carrying its history: every size variation of the asset, the impression bucket, the per-region breakdown with first and last shown dates and a per-surface impression split inside each region, the format, Google's category label and the funder disclosure on political ads. Impressions and first_shown are EEA-only (DSA-compelled) and come back null for US creatives, and an impression bucket may carry only a lower or only an upper bound. Costs 1 credit.",
+        import_zod.z.object({
+          advertiser_id: str("Google advertiser id, e.g. 'AR16735076323512287233' (3-40 characters)."),
+          creative_id: str("Creative id (3-40 characters). It must belong to the advertiser_id sent with it -- the lookup is keyed by the pair and a mismatched pair is a 404.")
+        }),
+        (i) => client.googleAds.creative(i)
+      )
+    );
+  }
+  if (all || enableMetaAds) {
+    tools.push(
+      tool(
+        "META_ADS_SEARCH",
+        "Scavio Meta Ads Search",
+        "Search the Meta Ad Library by keyword: 30 ads on page 1 with the full creative -- page name, ad copy, headline, CTA, images and videos, the platforms each ran on and its run dates -- then 10 ads per cursor page, walking has_next_page to the end of the query. total_results caps at 50000 with total_is_capped true, because Meta only reports '>50,000'; never present it as an exact count. Every page costs 1 credit.",
+        import_zod.z.object({
+          query: str("Keyword to search the ad library for (1-200 characters)."),
+          country: ostr("Ad library country as an exactly 2-character ISO 3166-1 alpha-2 code (server default 'US')."),
+          active_status: ostr("Whether the ad is still running (server default 'all'). Accepted values: 'all', 'active', 'inactive'."),
+          ad_type: ostr("Set 'political_and_issue_ads' to expose spend, reach, impressions and the paid-for-by disclosure; commercial ads leave all four null (server default 'all')."),
+          media_type: ostr("Creative media filter. Default: no media filter. Accepted values: 'all', 'image', 'video', 'meme', 'image_and_meme', 'none'."),
+          search_type: ostr("How the query is matched (server default 'keyword_unordered'). Accepted values: 'keyword_unordered', 'keyword_exact_phrase'."),
+          cursor: ostr("next_cursor from the previous response: page 1 is 30 ads, every cursor page is 10. The cursor is a self-contained blob, so ALL other filters are ignored when it is present.")
+        }),
+        (i) => client.metaAds.search(i)
+      ),
+      tool(
+        "META_ADS_ADVERTISER",
+        "Scavio Meta Ads Advertiser",
+        "Every ad a Facebook Page is running, by numeric page id: 30 ads on page 1 with the same creative detail as search(), then 10 ads per cursor page, walking has_next_page to the end of the advertiser. Every page costs 1 credit.",
+        import_zod.z.object({
+          page_id: str("The advertiser's numeric Facebook Page id (3-25 digits, as a string)."),
+          country: ostr("Ad library country as an exactly 2-character ISO 3166-1 alpha-2 code (server default 'US')."),
+          active_status: ostr("Whether the ad is still running (server default 'all'). Accepted values: 'all', 'active', 'inactive'."),
+          ad_type: ostr("Set 'political_and_issue_ads' to expose spend, reach, impressions and the paid-for-by disclosure; commercial ads leave all four null (server default 'all')."),
+          media_type: ostr("Creative media filter. Default: no media filter. Accepted values: 'all', 'image', 'video', 'meme', 'image_and_meme', 'none'."),
+          cursor: ostr("next_cursor from the previous response: page 1 is 30 ads, every cursor page is 10. ALL other filters are ignored when it is present.")
+        }),
+        (i) => client.metaAds.advertiser(i)
+      ),
+      tool(
+        "META_ADS_AD",
+        "Scavio Meta Ads Ad",
+        "One Meta ad in full by archive id: creative, advertiser, run dates, the platforms it ran on, and the political disclosure when the ad carries one. Commercial ads leave spend, reach and impressions null. Costs 1 credit.",
+        import_zod.z.object({
+          ad_archive_id: str("Meta ad archive id (3-25 digits, as a string).")
+        }),
+        (i) => client.metaAds.ad(i)
+      )
+    );
+  }
+  if (all || enableExtract) {
+    tools.push(
+      tool(
+        "EXTRACT",
+        "Scavio Extract",
+        "Read any URL and get the page back as raw HTML, readability Markdown or plain text: { url, format, mode, content, content_length }. Tier-priced by mode: 'normal' and 'advanced' cost 1 credit, 'ultra' costs 2. Only a successful extraction is billed - a dead link, bot wall or timeout costs nothing.",
+        import_zod.z.object({
+          url: str("Page to read (1-2048 characters). http(s) only; a bare host is upgraded to https, and loopback, private, link-local and metadata hosts are rejected with a 400."),
+          format: ostr("Output format: 'html' is the raw page, 'markdown' a readability extraction, 'text' that markdown flattened to plain text (server default 'markdown')."),
+          mode: ostr("Fetch tier, and the price-bearing parameter: 'normal' plain datacenter fetch (1 credit), 'advanced' full browser render (1 credit), 'ultra' the hardest-target tier (2 credits). Server default 'normal'.")
+        }),
+        (i) => client.extract(i)
+      )
+    );
+  }
   return (0, import_core.experimental_createToolkit)("SCAVIO", {
     name: "Scavio",
-    description: "Real-time structured search over Google (SERP, AI Mode, Maps, Shopping, Flights, Hotels, News, Trends), YouTube, Amazon, Walmart, Reddit, TikTok, TikTok Shop, Instagram, X and LinkedIn.",
+    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.",
     tools
   });
 }