composio-scavio 0.1.0 → 0.2.0

package/README.md

@@ -2,7 +2,21 @@
 
 [Scavio](https://scavio.dev) real-time search tools for [Composio](https://composio.dev) (TypeScript).
 
-Scavio is a single Search API over Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram. This package exposes those endpoints as a Composio custom toolkit so your agents can pull structured, up-to-date results across any Composio-supported framework.
+Scavio is a single Search API over Google, YouTube, Amazon, Walmart, Reddit, TikTok, TikTok Shop, Instagram, X and LinkedIn. This package exposes the Google, YouTube, Amazon, Walmart, Reddit, TikTok and Instagram endpoints as a Composio custom toolkit so your agents can pull structured, up-to-date results across any Composio-supported framework.
+
+> **Amazon changed (breaking).** The upstream provider moved in 2026-07:
+> `domain` is replaced by `country`, a two-letter marketplace code (`us`, `gb`
+> -- the UK is `gb`, not `uk` -- `de`, `jp`, ...), and `sort_by`, `pages`,
+> `category_id`, `merchant_id`, `language`, `currency`, `device`, `zip_code`
+> and `autoselect_variant` are gone. The marketplace ignores all of them
+> (`sort_by` returns the identical unordered set for every value), so they are
+> removed rather than kept as silent no-ops. Rank and filter results yourself.
+
+> **Reddit search has no filters.** `/reddit/search` accepts only `query` and
+> `cursor`; the API strips anything else, so the old `type` and `sort` args
+> narrowed nothing and are removed. It returns `data.results` with `next_cursor`
+> and `has_more`. `REDDIT_POST` returns the post itself only -- comments are not
+> included.
 
 ## Install
 
@@ -10,7 +24,7 @@ Scavio is a single Search API over Google, YouTube, Amazon, Walmart, Reddit, Tik
 npm install composio-scavio
 ```
 
-`@composio/core` and `zod` are dependencies. Get a Scavio API key from the [Scavio Dashboard](https://dashboard.scavio.dev) (50 free credits to start, no credit card).
+`@composio/core` and `zod` are dependencies. Get a Scavio API key from the [Scavio Dashboard](https://dashboard.scavio.dev) (50 one-time signup credits, no credit card; the free plan does not refill monthly).
 
 ## Usage
 
@@ -36,7 +50,7 @@ const session = await composio.create("user_1", {
 const tools = await session.tools();
 const out = await session.execute("LOCAL_SCAVIO_GOOGLE_SEARCH", {
   query: "best search API for AI agents",
-  light_request: true,
+  countryCode: "us",
 });
 console.log(out);
 ```
@@ -45,11 +59,11 @@ Pass `all: true` to register every tool regardless of the individual flags.
 
 ## Tools
 
-All tools are grouped under the `SCAVIO` custom toolkit; agent-facing slugs are prefixed `LOCAL_SCAVIO_` (Composio convention for custom tools). Providers: Google, Amazon (search, product), Walmart (search, product), YouTube (search, metadata), Reddit (search, post), TikTok (11 tools), Instagram (12 tools). 32 tools total.
+All tools are grouped under the `SCAVIO` custom toolkit; agent-facing slugs are prefixed `LOCAL_SCAVIO_` (Composio convention for custom tools). Providers: Google, Amazon (search, product, offers), Walmart (search, product), YouTube (16 tools: search, shorts, suggestions, video, metadata, comments, comment replies, transcript, related, channel search, channel, channel videos, channel shorts, channel community, channel resolve, streams), Reddit (search, post), TikTok (11 tools), Instagram (12 tools). 47 tools total.
 
 ## Credits
 
-Most endpoints cost 1 credit. Reddit and Instagram cost 2 credits each. Google costs 2 credits unless `light_request: true` (1 credit). See [scavio.dev/docs](https://scavio.dev/docs).
+Most endpoints cost 1 credit, including Google (`/api/v2/google`), Reddit, TikTok, Amazon and Walmart. Instagram costs 10 credits per call, except post and comment replies (8) and user posts (2). YouTube search and shorts cost 2, YouTube streams 3, and YouTube transcript 8. See [scavio.dev/docs](https://scavio.dev/docs).
 
 ## Links
 

package/dist/index.cjs

@@ -31,6 +31,15 @@ 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);
+function googleSearchParams(i) {
+  const params = { query: i.query };
+  if (i.countryCode != null) params.gl = i.countryCode;
+  if (i.language != null) params.hl = i.language;
+  if (i.page != null && i.page > 1) params.start = (i.page - 1) * 10;
+  if (i.device != null) params.device = i.device;
+  if (i.nfpr != null) params.nfpr = i.nfpr;
+  return params;
+}
 function buildScavioToolkit(options = {}) {
   const {
     apiKey,
@@ -58,18 +67,16 @@ function buildScavioToolkit(options = {}) {
       tool(
         "GOOGLE_SEARCH",
         "Scavio Google Search",
-        "Search Google for real-time web results (organic, knowledge graph, news, and more).",
+        "Search Google for real-time web results (organic_results, ads, and the AI Overview when present). Costs 1 credit.",
         import_zod.z.object({
           query: str("The search query."),
-          country_code: ostr("Two-letter country code, e.g. 'us'."),
+          countryCode: ostr("Two-letter country code, e.g. 'us'."),
           language: ostr("Two-letter language code, e.g. 'en'."),
           page: onum("Result page number (1-based)."),
-          search_type: ostr("Search vertical, e.g. 'search', 'news', 'images'."),
           device: ostr("Device profile: 'desktop' or 'mobile'."),
-          nfpr: obool("Disable auto-correction of the query when true."),
-          light_request: obool("Cheaper, lighter response (1 credit instead of 2) when true.")
+          nfpr: obool("Disable auto-correction of the query when true.")
         }),
-        (i) => client.google.search(i)
+        (i) => client.google.search(googleSearchParams(i))
       )
     );
   }
@@ -78,39 +85,33 @@ function buildScavioToolkit(options = {}) {
       tool(
         "AMAZON_SEARCH",
         "Scavio Amazon Search",
-        "Search Amazon for products matching a query.",
+        "Search Amazon for products matching a query. Results are unsorted and cannot be filtered by category, merchant or price. Costs 1 credit.",
         import_zod.z.object({
           query: str("The product search query."),
-          domain: ostr("Amazon domain, e.g. 'amazon.com'."),
-          country: ostr("Two-letter country code."),
-          language: ostr("Two-letter language code."),
-          currency: ostr("Currency code, e.g. 'USD'."),
-          device: ostr("Device profile: 'desktop' or 'mobile'."),
-          sort_by: ostr("Sort order for results."),
-          start_page: onum("First page to return."),
-          pages: onum("Number of pages to return."),
-          category_id: ostr("Restrict to an Amazon category id."),
-          merchant_id: ostr("Restrict to a merchant id."),
-          zip_code: ostr("Delivery ZIP/postal code."),
-          autoselect_variant: obool("Auto-select the best product variant when true.")
+          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."),
+          page: onum("Result page, 1-based. One page per call, 1 credit each.")
         }),
         (i) => client.amazon.search(i)
       ),
       tool(
         "AMAZON_PRODUCT",
         "Scavio Amazon Product",
-        "Fetch full Amazon product details by ASIN.",
+        "Fetch full Amazon product details by ASIN. price is the buy-box price only. Costs 1 credit.",
         import_zod.z.object({
           asin: str("Amazon Standard Identification Number (ASIN) of the product."),
-          domain: ostr("Amazon domain, e.g. 'amazon.com'."),
-          country: ostr("Two-letter country code."),
-          language: ostr("Two-letter language code."),
-          currency: ostr("Currency code, e.g. 'USD'."),
-          device: ostr("Device profile: 'desktop' or 'mobile'."),
-          zip_code: ostr("Delivery ZIP/postal code."),
-          autoselect_variant: obool("Auto-select the best product variant when true.")
+          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.product(i)
+      ),
+      tool(
+        "AMAZON_OFFERS",
+        "Scavio Amazon Offers",
+        "List every seller offer for one Amazon ASIN: price, seller, condition, shipping, and which offer holds the buy box. Page 1 only. Use this instead of AMAZON_PRODUCT when comparing sellers or checking who owns the buy box. Costs 1 credit.",
+        import_zod.z.object({
+          asin: str("Amazon Standard Identification Number (ASIN) of the product."),
+          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)
       )
     );
   }
@@ -119,7 +120,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "WALMART_SEARCH",
         "Scavio Walmart Search",
-        "Search Walmart for products matching a query.",
+        "Search Walmart for products matching a query. Costs 1 credit.",
         import_zod.z.object({
           query: str("The product search query."),
           domain: ostr("Walmart domain."),
@@ -138,7 +139,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "WALMART_PRODUCT",
         "Scavio Walmart Product",
-        "Fetch full Walmart product details by product id.",
+        "Fetch full Walmart product details by product id. Costs 1 credit.",
         import_zod.z.object({
           product_id: str("Walmart product id."),
           domain: ostr("Walmart domain."),
@@ -155,13 +156,15 @@ function buildScavioToolkit(options = {}) {
       tool(
         "YOUTUBE_SEARCH",
         "Scavio YouTube Search",
-        "Search YouTube for videos, channels, or playlists.",
+        "Search YouTube for videos, channels, or playlists. Costs 2 credits.",
         import_zod.z.object({
           query: str("The video search query."),
-          upload_date: ostr("Upload date filter, e.g. 'today', 'week', 'month'."),
-          type: ostr("Result type, e.g. 'video', 'channel', 'playlist'."),
-          duration: ostr("Duration filter, e.g. 'short', 'long'."),
-          sort_by: ostr("Sort order for results."),
+          upload_date: ostr("Upload date filter: 'last_hour', 'today', 'this_week', 'this_month', 'this_year'."),
+          type: ostr("Result type: 'video', 'channel', 'playlist', or 'movie'."),
+          duration: ostr("Duration filter: 'short', 'medium', or 'long'."),
+          sort_by: ostr("Sort order: 'relevance', 'date', 'view_count', or 'rating'."),
+          features: import_zod.z.array(import_zod.z.string()).optional().describe("Feature filters, e.g. ['hd', '4k', 'subtitles', 'creative_commons', 'live', '360', '3d', 'hdr', 'vr180']."),
+          cursor: ostr("Pagination cursor from a prior response."),
           hd: obool("Restrict to HD videos when true."),
           subtitles: obool("Restrict to videos with subtitles when true."),
           creative_commons: obool("Restrict to Creative Commons videos when true."),
@@ -169,12 +172,144 @@ function buildScavioToolkit(options = {}) {
         }),
         (i) => client.youtube.search(i)
       ),
+      tool(
+        "YOUTUBE_SHORTS",
+        "Scavio YouTube Shorts",
+        "Search YouTube Shorts. Costs 2 credits.",
+        import_zod.z.object({
+          query: str("The Shorts search query."),
+          sort_by: ostr("Sort order: 'relevance', 'date', 'view_count', or 'rating'."),
+          cursor: ostr("Pagination cursor from a prior response.")
+        }),
+        (i) => client.youtube.shorts(i)
+      ),
+      tool(
+        "YOUTUBE_SUGGESTIONS",
+        "Scavio YouTube Suggestions",
+        "Get YouTube search autocomplete suggestions for a partial query. Costs 1 credit.",
+        import_zod.z.object({
+          query: str("The partial query to autocomplete."),
+          language: ostr("Suggestion language (ISO 639-1, default 'en')."),
+          region: ostr("Region code (ISO 3166-1 alpha-2, default 'US').")
+        }),
+        (i) => client.youtube.suggestions(i)
+      ),
+      tool(
+        "YOUTUBE_VIDEO",
+        "Scavio YouTube Video",
+        "Fetch full metadata for a YouTube video by id or watch URL. Costs 1 credit.",
+        import_zod.z.object({ video_id: str("YouTube video id or a full watch URL.") }),
+        (i) => client.youtube.video(i)
+      ),
       tool(
         "YOUTUBE_METADATA",
         "Scavio YouTube Metadata",
-        "Fetch metadata for a YouTube video by id.",
-        import_zod.z.object({ video_id: str("YouTube video id.") }),
+        "Fetch metadata for a YouTube video by id. Deprecated alias of YOUTUBE_VIDEO.",
+        import_zod.z.object({ video_id: str("YouTube video id or a full watch URL.") }),
         (i) => client.youtube.metadata(i)
+      ),
+      tool(
+        "YOUTUBE_COMMENTS",
+        "Scavio YouTube Comments",
+        "List top-level comments on a YouTube video. Costs 1 credit.",
+        import_zod.z.object({
+          video_id: str("YouTube video id or a full watch URL."),
+          cursor: ostr("Pagination cursor from a prior response.")
+        }),
+        (i) => client.youtube.comments(i)
+      ),
+      tool(
+        "YOUTUBE_COMMENT_REPLIES",
+        "Scavio YouTube Comment Replies",
+        "List replies to a YouTube comment using its reply cursor. Costs 1 credit.",
+        import_zod.z.object({
+          video_id: str("YouTube video id or a full watch URL."),
+          reply_cursor: str("Reply cursor from a parent comment's 'reply_cursor' field."),
+          cursor: ostr("Pagination cursor from a prior response.")
+        }),
+        (i) => client.youtube.commentReplies(i)
+      ),
+      tool(
+        "YOUTUBE_TRANSCRIPT",
+        "Scavio YouTube Transcript",
+        "Fetch the transcript or timed captions for a YouTube video. Costs 8 credits.",
+        import_zod.z.object({
+          video_id: str("YouTube video id or a full watch URL."),
+          language: ostr("Caption language code (default 'en')."),
+          format: ostr("'text' for a plain transcript or 'srt' for timed subtitles (default 'text').")
+        }),
+        (i) => client.youtube.transcript(i)
+      ),
+      tool(
+        "YOUTUBE_RELATED",
+        "Scavio YouTube Related",
+        "List videos related to a YouTube video. Costs 1 credit.",
+        import_zod.z.object({
+          video_id: str("YouTube video id or a full watch URL."),
+          cursor: ostr("Pagination cursor from a prior response.")
+        }),
+        (i) => client.youtube.related(i)
+      ),
+      tool(
+        "YOUTUBE_CHANNEL_SEARCH",
+        "Scavio YouTube Channel Search",
+        "Search YouTube channels by keyword. Costs 1 credit.",
+        import_zod.z.object({
+          query: str("The channel search query."),
+          cursor: ostr("Pagination cursor from a prior response.")
+        }),
+        (i) => client.youtube.channelSearch(i)
+      ),
+      tool(
+        "YOUTUBE_CHANNEL",
+        "Scavio YouTube Channel",
+        "Fetch YouTube channel details by id, @handle, or URL. Costs 1 credit.",
+        import_zod.z.object({ channel_id: str("YouTube channel id, @handle, or channel URL.") }),
+        (i) => client.youtube.channel(i)
+      ),
+      tool(
+        "YOUTUBE_CHANNEL_VIDEOS",
+        "Scavio YouTube Channel Videos",
+        "List videos uploaded by a YouTube channel. Costs 1 credit.",
+        import_zod.z.object({
+          channel_id: str("YouTube channel id."),
+          cursor: ostr("Pagination cursor from a prior response.")
+        }),
+        (i) => client.youtube.channelVideos(i)
+      ),
+      tool(
+        "YOUTUBE_CHANNEL_SHORTS",
+        "Scavio YouTube Channel Shorts",
+        "List Shorts posted by a YouTube channel. Costs 1 credit.",
+        import_zod.z.object({
+          channel_id: str("YouTube channel id."),
+          cursor: ostr("Pagination cursor from a prior response.")
+        }),
+        (i) => client.youtube.channelShorts(i)
+      ),
+      tool(
+        "YOUTUBE_CHANNEL_COMMUNITY",
+        "Scavio YouTube Channel Community",
+        "List community posts from a YouTube channel. Costs 1 credit.",
+        import_zod.z.object({
+          channel_id: str("YouTube channel id."),
+          cursor: ostr("Pagination cursor from a prior response.")
+        }),
+        (i) => client.youtube.channelCommunity(i)
+      ),
+      tool(
+        "YOUTUBE_CHANNEL_RESOLVE",
+        "Scavio YouTube Channel Resolve",
+        "Resolve a YouTube @handle or channel URL to a channel id. Costs 1 credit.",
+        import_zod.z.object({ channel: str("A channel @handle or channel URL to resolve to a channel id.") }),
+        (i) => client.youtube.channelResolve(i)
+      ),
+      tool(
+        "YOUTUBE_STREAMS",
+        "Scavio YouTube Streams",
+        "Fetch playable or downloadable stream formats for a YouTube video. Costs 3 credits.",
+        import_zod.z.object({ video_id: str("YouTube video id or a full watch URL.") }),
+        (i) => client.youtube.streams(i)
       )
     );
   }
@@ -183,20 +318,18 @@ function buildScavioToolkit(options = {}) {
       tool(
         "REDDIT_SEARCH",
         "Scavio Reddit Search",
-        "Search Reddit posts, subreddits, or users.",
+        "Search Reddit posts. Returns data.results with next_cursor and has_more; page with cursor. Results cannot be filtered or sorted. Costs 1 credit.",
         import_zod.z.object({
           query: str("The Reddit search query."),
-          type: ostr("Search type, e.g. 'posts', 'subreddits', 'users'."),
-          sort: ostr("Sort order, e.g. 'relevance', 'new', 'top'."),
-          cursor: ostr("Pagination cursor.")
+          cursor: ostr("Pagination cursor: pass 'next_cursor' from a prior response.")
         }),
         (i) => client.reddit.search(i)
       ),
       tool(
         "REDDIT_POST",
         "Scavio Reddit Post",
-        "Fetch a Reddit post and its comment thread by URL.",
-        import_zod.z.object({ url: str("Full URL of the Reddit post to fetch with its comments.") }),
+        "Fetch one Reddit post by URL. Returns a flat post object under data (post_id, title, text, url, subreddit, author, score, upvote_ratio, num_comments, created_at, is_nsfw, is_video, thumbnail, media); comments are NOT included. Costs 1 credit.",
+        import_zod.z.object({ url: str("Full URL of the Reddit post.") }),
         (i) => client.reddit.post(i)
       )
     );
@@ -206,7 +339,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "TIKTOK_PROFILE",
         "Scavio TikTok Profile",
-        "Fetch a TikTok user profile by username or secUid.",
+        "Fetch a TikTok user profile by username or secUid. Costs 1 credit.",
         import_zod.z.object({
           username: ostr("TikTok username (without @). Provide this or sec_user_id."),
           sec_user_id: ostr("TikTok secUid. Provide this or username.")
@@ -216,7 +349,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "TIKTOK_USER_POSTS",
         "Scavio TikTok User Posts",
-        "List a TikTok user's posts by secUid.",
+        "List a TikTok user's posts by secUid. Costs 1 credit.",
         import_zod.z.object({
           sec_user_id: str("TikTok secUid of the user."),
           cursor: ostr("Pagination cursor."),
@@ -228,14 +361,14 @@ function buildScavioToolkit(options = {}) {
       tool(
         "TIKTOK_VIDEO",
         "Scavio TikTok Video",
-        "Fetch a TikTok video by id.",
+        "Fetch a TikTok video by id. Costs 1 credit.",
         import_zod.z.object({ video_id: str("TikTok video id.") }),
         (i) => client.tiktok.video(i)
       ),
       tool(
         "TIKTOK_VIDEO_COMMENTS",
         "Scavio TikTok Video Comments",
-        "List comments on a TikTok video.",
+        "List comments on a TikTok video. Costs 1 credit.",
         import_zod.z.object({
           video_id: str("TikTok video id."),
           cursor: ostr("Pagination cursor."),
@@ -246,7 +379,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "TIKTOK_COMMENT_REPLIES",
         "Scavio TikTok Comment Replies",
-        "List replies to a TikTok video comment.",
+        "List replies to a TikTok video comment. Costs 1 credit.",
         import_zod.z.object({
           video_id: str("TikTok video id."),
           comment_id: str("Parent comment id."),
@@ -258,7 +391,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "TIKTOK_SEARCH_VIDEOS",
         "Scavio TikTok Search Videos",
-        "Search TikTok videos by keyword.",
+        "Search TikTok videos by keyword. Costs 1 credit.",
         import_zod.z.object({
           keyword: str("Search keyword."),
           cursor: ostr("Pagination cursor."),
@@ -271,7 +404,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "TIKTOK_SEARCH_USERS",
         "Scavio TikTok Search Users",
-        "Search TikTok users by keyword.",
+        "Search TikTok users by keyword. Costs 1 credit.",
         import_zod.z.object({
           keyword: str("Search keyword."),
           cursor: ostr("Pagination cursor."),
@@ -282,7 +415,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "TIKTOK_HASHTAG",
         "Scavio TikTok Hashtag",
-        "Fetch a TikTok hashtag by name or id.",
+        "Fetch a TikTok hashtag by name or id. Costs 1 credit.",
         import_zod.z.object({
           hashtag_name: ostr("Hashtag name (without #). Provide this or hashtag_id."),
           hashtag_id: ostr("Hashtag id. Provide this or hashtag_name.")
@@ -292,7 +425,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "TIKTOK_HASHTAG_VIDEOS",
         "Scavio TikTok Hashtag Videos",
-        "List videos for a TikTok hashtag by id.",
+        "List videos for a TikTok hashtag by id. Costs 1 credit.",
         import_zod.z.object({
           hashtag_id: str("Hashtag id."),
           cursor: ostr("Pagination cursor."),
@@ -303,7 +436,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "TIKTOK_USER_FOLLOWERS",
         "Scavio TikTok User Followers",
-        "List a TikTok user's followers by secUid.",
+        "List a TikTok user's followers by secUid. Costs 1 credit.",
         import_zod.z.object({
           sec_user_id: str("TikTok secUid of the user."),
           count: onum("Number of followers to return."),
@@ -315,7 +448,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "TIKTOK_USER_FOLLOWINGS",
         "Scavio TikTok User Followings",
-        "List the accounts a TikTok user follows, by secUid.",
+        "List the accounts a TikTok user follows, by secUid. Costs 1 credit.",
         import_zod.z.object({
           sec_user_id: str("TikTok secUid of the user."),
           count: onum("Number of followings to return."),
@@ -331,7 +464,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_PROFILE",
         "Scavio Instagram Profile",
-        "Fetch an Instagram profile by username or user id.",
+        "Fetch an Instagram profile by username or user id. Costs 10 credits.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username.")
@@ -341,7 +474,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_POSTS",
         "Scavio Instagram User Posts",
-        "List an Instagram user's posts.",
+        "List an Instagram user's posts. Costs 2 credits, the cheapest Instagram endpoint.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username."),
@@ -353,7 +486,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_REELS",
         "Scavio Instagram User Reels",
-        "List an Instagram user's reels.",
+        "List an Instagram user's reels. Costs 10 credits.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username."),
@@ -365,7 +498,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_TAGGED",
         "Scavio Instagram User Tagged",
-        "List posts an Instagram user is tagged in.",
+        "List posts an Instagram user is tagged in. Costs 10 credits.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username."),
@@ -377,7 +510,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_STORIES",
         "Scavio Instagram User Stories",
-        "Fetch an Instagram user's current stories.",
+        "Fetch an Instagram user's current stories. Costs 10 credits.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username.")
@@ -387,7 +520,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_POST",
         "Scavio Instagram Post",
-        "Fetch an Instagram post by URL, media id, or shortcode.",
+        "Fetch an Instagram post by URL, media id, or shortcode. Costs 8 credits.",
         import_zod.z.object({
           url: ostr("Post URL. Provide one of url, media_id, or shortcode."),
           media_id: ostr("Post media id. Provide one of url, media_id, or shortcode."),
@@ -398,7 +531,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_POST_COMMENTS",
         "Scavio Instagram Post Comments",
-        "List comments on an Instagram post by shortcode or URL.",
+        "List comments on an Instagram post by shortcode or URL. Costs 10 credits.",
         import_zod.z.object({
           shortcode: ostr("Post shortcode. Provide this or url."),
           url: ostr("Post URL. Provide this or shortcode."),
@@ -410,7 +543,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_COMMENT_REPLIES",
         "Scavio Instagram Comment Replies",
-        "List replies to an Instagram post comment.",
+        "List replies to an Instagram post comment. Costs 8 credits.",
         import_zod.z.object({
           media_id: str("Post media id."),
           comment_id: str("Parent comment id."),
@@ -421,7 +554,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_SEARCH_USERS",
         "Scavio Instagram Search Users",
-        "Search Instagram users by keyword.",
+        "Search Instagram users by keyword. Costs 10 credits.",
         import_zod.z.object({
           keyword: str("Search keyword."),
           cursor: ostr("Pagination cursor.")
@@ -431,7 +564,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_SEARCH_HASHTAGS",
         "Scavio Instagram Search Hashtags",
-        "Search Instagram hashtags by keyword.",
+        "Search Instagram hashtags by keyword. Costs 10 credits.",
         import_zod.z.object({
           keyword: str("Search keyword."),
           cursor: ostr("Pagination cursor.")
@@ -441,7 +574,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_FOLLOWERS",
         "Scavio Instagram User Followers",
-        "List an Instagram user's followers.",
+        "List an Instagram user's followers. Costs 10 credits.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username."),
@@ -453,7 +586,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_FOLLOWINGS",
         "Scavio Instagram User Followings",
-        "List the accounts an Instagram user follows.",
+        "List the accounts an Instagram user follows. Costs 10 credits.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username."),
@@ -466,7 +599,7 @@ function buildScavioToolkit(options = {}) {
   }
   return (0, import_core.experimental_createToolkit)("SCAVIO", {
     name: "Scavio",
-    description: "Real-time structured search over Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram.",
+    description: "Real-time structured search over Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram (part of the Scavio API, which also covers TikTok Shop, X and LinkedIn).",
     tools
   });
 }