npm - @scavio/ai-sdk - Versions diffs - 0.2.2 → 0.4.0 - Mend

@scavio/ai-sdk 0.2.2 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -1,8 +1,31 @@
 # @scavio/ai-sdk
-Scavio search tools for the [Vercel AI SDK](https://sdk.vercel.ai). Give any AI SDK agent real-time
-search across Google, YouTube, Reddit, Amazon, Walmart, TikTok, and Instagram via the
-[Scavio](https://scavio.dev) API.
+Scavio search and page-extraction tools for the [Vercel AI SDK](https://sdk.vercel.ai). Give any AI
+SDK agent real-time search across Google, YouTube, Reddit, Amazon, Walmart, TikTok, and Instagram --
+plus `scavio_extract`, which reads any URL -- via the [Scavio](https://scavio.dev) API.
+**This package exposes a curated subset of the Scavio API**, chosen for agent
+use: 13 tools -- 12 over 7 platforms, plus the core `extract` endpoint, which
+belongs to no platform. The full surface is 195 endpoints across 31 platforms,
+adding X, LinkedIn, TikTok Shop, eBay, Target, Home Depot, Zillow, Redfin,
+Booking, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the App Store, Google
+Play, SEC, Companies House, G2, Capterra, Google Ads, Meta Ad Library, Threads,
+Kuaishou and the Google verticals (Maps, Shopping, News, Flights, Hotels,
+Trends, AI Mode). To reach all of them, point your agent at the
+[Scavio MCP server](https://scavio.dev/docs/mcp-server) at `mcp.scavio.dev` --
+191 tools over every endpoint, nothing to vendor.
+Credits are not uniform: most calls cost 1, YouTube search costs 2 and
+transcript costs 8, Instagram costs 2 to 10 depending on the endpoint, and
+`scavio_extract` is priced by the `mode` you ask for (1 / 1 / 2), not per call.
+> **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.
 ## Install
@@ -22,7 +45,7 @@ import { scavioSearch, scavioTools } from "@scavio/ai-sdk";
 // A single tool:
 const res = await generateText({
-  model: openai("gpt-4o-mini"),
+  model: openai("gpt-5.5"),
   tools: { scavio_search: scavioSearch({ maxResults: 5 }) },
   stopWhen: stepCountIs(3),
   prompt: "Find the official GitHub repo of the Agno framework",
@@ -30,7 +53,7 @@ const res = await generateText({
 // Or all tools at once:
 const res2 = await generateText({
-  model: openai("gpt-4o-mini"),
+  model: openai("gpt-5.5"),
   tools: scavioTools(),
   stopWhen: stepCountIs(3),
   prompt: "Compare prices for a mechanical keyboard on Amazon and Walmart",
@@ -41,17 +64,54 @@ const res2 = await generateText({
 | Factory | Tool name | Provider |
 | --- | --- | --- |
-| `scavioSearch` | `scavio_search` | Google web search |
-| `scavioYoutubeSearch` | `scavio_youtube_search` | YouTube video search |
-| `scavioRedditSearch` | `scavio_reddit_search` | Reddit (2 credits) |
-| `scavioAmazonSearch` | `scavio_amazon_search` | Amazon products |
-| `scavioWalmartSearch` | `scavio_walmart_search` | Walmart products |
-| `scavioTiktokSearch` | `scavio_tiktok_search` | TikTok videos |
-| `scavioInstagramSearch` | `scavio_instagram_search` | Instagram users |
+| `scavioExtract` | `scavio_extract` | Read any URL as Markdown / text / HTML, `/api/v1/extract` (1 credit on `normal` and `advanced`, 2 on `ultra`) |
+| `scavioSearch` | `scavio_search` | Google web search, `/api/v2/google` (1 credit) |
+| `scavioYoutubeSearch` | `scavio_youtube_search` | YouTube video search (2 credits) |
+| `scavioYoutubeVideo` | `scavio_youtube_video` | YouTube video details (1 credit) |
+| `scavioYoutubeTranscript` | `scavio_youtube_transcript` | YouTube transcript / subtitles (8 credits) |
+| `scavioYoutubeComments` | `scavio_youtube_comments` | YouTube video comments (1 credit) |
+| `scavioYoutubeChannel` | `scavio_youtube_channel` | YouTube channel details (1 credit) |
+| `scavioRedditSearch` | `scavio_reddit_search` | Reddit posts (1 credit) |
+| `scavioAmazonSearch` | `scavio_amazon_search` | Amazon products (1 credit) |
+| `scavioAmazonOffers` | `scavio_amazon_offers` | Amazon seller offers for one ASIN (1 credit) |
+| `scavioWalmartSearch` | `scavio_walmart_search` | Walmart products (1 credit) |
+| `scavioTiktokSearch` | `scavio_tiktok_search` | TikTok videos (1 credit) |
+| `scavioInstagramSearch` | `scavio_instagram_search` | Instagram users (10 credits) |
 | `scavioTools` | all of the above | bundle for `tools:` |
 Each factory accepts `{ apiKey?, maxResults?, ...ScavioConfig }`. The key falls back to `SCAVIO_API_KEY`.
-Get a key at [dashboard.scavio.dev](https://dashboard.scavio.dev).
+Get a key at [dashboard.scavio.dev](https://dashboard.scavio.dev) - new accounts get 50 free credits, no
+credit card.
+`maxResults` trims the result list in place. Google returns a flat body, so it trims
+`organic_results`; every other endpoint nests its payload under `data`, so those trim inside `data`
+(`data.results`, `data.products`, `data.aweme_list`, `data.users`, ...) and the
+`{ data, response_time, credits_used, credits_remaining }` envelope is preserved. `scavioExtract`
+ignores `maxResults`: it returns page content, not a list, so the page comes back whole.
+### Reading a page
+```ts
+const page = await generateText({
+  model: openai("gpt-5.5"),
+  tools: { scavio_extract: scavioExtract() },
+  stopWhen: stepCountIs(3),
+  prompt: "Summarise the pricing page at https://scavio.dev/pricing",
+});
+```
+`scavio_extract` takes `url` plus an optional `format` (`markdown` default, `text`, `html`) and
+`mode`. `mode` is the price-bearing param: `normal` is a plain fetch (1 credit), `advanced` renders
+the page in a browser for JS-built sites (1 credit), and `ultra` routes through residential proxies
+for the hardest bot walls (2 credits). Only a successful read is billed - a dead link, a bot wall or
+a timeout costs nothing. See [the extract docs](https://scavio.dev/docs/extract).
+These tools cover the most common surfaces. The full Scavio API - 195 endpoints across 31 platforms
+(Google, YouTube, Amazon, Walmart, Reddit, TikTok, TikTok Shop, Instagram, X, LinkedIn, eBay, Target,
+Home Depot, Zillow, Redfin, Booking, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the App Store,
+Google Play, SEC, Companies House, G2, Capterra, Google Ads, Meta Ad Library, Threads and Kuaishou),
+plus `extract` - is available directly through the
+[`scavio`](https://www.npmjs.com/package/scavio) SDK or the [MCP server](https://scavio.dev/docs).
 ## License

package/dist/index.cjs CHANGED Viewed

@@ -20,14 +20,20 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  scavioAmazonOffers: () => scavioAmazonOffers,
   scavioAmazonSearch: () => scavioAmazonSearch,
+  scavioExtract: () => scavioExtract,
   scavioInstagramSearch: () => scavioInstagramSearch,
   scavioRedditSearch: () => scavioRedditSearch,
   scavioSearch: () => scavioSearch,
   scavioTiktokSearch: () => scavioTiktokSearch,
   scavioTools: () => scavioTools,
   scavioWalmartSearch: () => scavioWalmartSearch,
-  scavioYoutubeSearch: () => scavioYoutubeSearch
+  scavioYoutubeChannel: () => scavioYoutubeChannel,
+  scavioYoutubeComments: () => scavioYoutubeComments,
+  scavioYoutubeSearch: () => scavioYoutubeSearch,
+  scavioYoutubeTranscript: () => scavioYoutubeTranscript,
+  scavioYoutubeVideo: () => scavioYoutubeVideo
 });
 module.exports = __toCommonJS(index_exports);
 var import_ai = require("ai");
@@ -36,20 +42,40 @@ var import_scavio = require("scavio");
 function client(config) {
   return new import_scavio.Scavio({ apiKey: config?.apiKey });
 }
-function trim(res, max) {
-  const results = res.results;
-  if (Array.isArray(results) && results.length > max) {
-    return { ...res, results: results.slice(0, max) };
+function trimFlat(res, key, max) {
+  const list = res[key];
+  if (Array.isArray(list) && list.length > max) {
+    return { ...res, [key]: list.slice(0, max) };
   }
   return res;
 }
-function trimList(res, key, max) {
-  const list = res[key];
+function trimData(res, key, max) {
+  const data = res.data;
+  if (!data || typeof data !== "object") return res;
+  const list = data[key];
   if (Array.isArray(list) && list.length > max) {
-    return { ...res, [key]: list.slice(0, max) };
+    return { ...res, data: { ...data, [key]: list.slice(0, max) } };
   }
   return res;
 }
+function scavioExtract(config) {
+  const c = client(config);
+  return (0, import_ai.tool)({
+    description: "Read any web page via the Scavio API and get it back as clean Markdown (default), plain text, or raw HTML. Use it on any URL, including one returned by the search tools. Returns `data.content` alongside `data.url`, `data.format`, `data.mode` and `data.content_length`. Cost depends on `mode`: 1 credit on 'normal' and 'advanced', 2 on 'ultra'; a dead link, bot wall or timeout is not billed.",
+    inputSchema: import_zod.z.object({
+      url: import_zod.z.string().describe(
+        "The 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."
+      ),
+      format: import_zod.z.enum(["html", "markdown", "text"]).optional().describe(
+        "Output format (default 'markdown'): 'markdown' is a readability extraction with page chrome stripped, 'text' is that flattened to plain text, 'html' is the raw page."
+      ),
+      mode: import_zod.z.enum(["normal", "advanced", "ultra"]).optional().describe(
+        "Fetch tier, and the parameter that sets the price: 'normal' (default) is a plain fetch and costs 1 credit, 'advanced' renders the page in a browser for JS-built sites and costs 1, 'ultra' routes through residential proxies for the hardest bot walls and costs 2. Start on 'normal'."
+      )
+    }),
+    execute: async ({ url, format, mode }) => c.extract({ url, format, mode })
+  });
+}
 function scavioSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
@@ -70,7 +96,7 @@ function scavioSearch(config) {
       if (page && page > 1) params.start = (page - 1) * 10;
       if (device) params.device = device;
       if (nfpr !== void 0) params.nfpr = nfpr;
-      return trimList(await c.google.search(params), "organic_results", max);
+      return trimFlat(await c.google.search(params), "organic_results", max);
     }
   });
 }
@@ -78,64 +104,138 @@ function scavioYoutubeSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return (0, import_ai.tool)({
-    description: "Search YouTube for videos via the Scavio API.",
+    description: "Search YouTube for videos, channels, or playlists via the Scavio API (2 credits). Videos come back under `data.results`, with `data.channels` and `data.playlists` alongside.",
+    inputSchema: import_zod.z.object({
+      query: import_zod.z.string().describe("The search query."),
+      upload_date: import_zod.z.string().optional().describe("Upload date filter, e.g. 'today', 'this_week', 'this_month'."),
+      type: import_zod.z.string().optional().describe("Result type: 'video', 'channel', 'playlist', 'movie'."),
+      duration: import_zod.z.string().optional().describe("Duration filter: 'short', 'medium', 'long'."),
+      sort_by: import_zod.z.string().optional().describe("Sort order: 'relevance', 'date', 'view_count', 'rating'."),
+      cursor: import_zod.z.string().optional().describe("Pagination cursor (`next_cursor`) from a prior response.")
+    }),
+    execute: async ({ query, upload_date, type, duration, sort_by, cursor }) => trimData(
+      await c.youtube.search({ query, upload_date, type, duration, sort_by, cursor }),
+      "results",
+      max
+    )
+  });
+}
+function scavioYoutubeVideo(config) {
+  const c = client(config);
+  return (0, import_ai.tool)({
+    description: "Fetch full details for a YouTube video (title, author, view count, description, captions, chapters) via the Scavio API.",
+    inputSchema: import_zod.z.object({
+      video_id: import_zod.z.string().describe("YouTube video id or a full watch URL.")
+    }),
+    execute: async ({ video_id }) => c.youtube.video({ video_id })
+  });
+}
+function scavioYoutubeTranscript(config) {
+  const c = client(config);
+  return (0, import_ai.tool)({
+    description: "Fetch a YouTube video's transcript or timed subtitles via the Scavio API (8 credits).",
+    inputSchema: import_zod.z.object({
+      video_id: import_zod.z.string().describe("YouTube video id or a full watch URL."),
+      language: import_zod.z.string().optional().describe("Transcript language code (default 'en')."),
+      format: import_zod.z.enum(["text", "srt"]).optional().describe("'text' for a plain transcript, 'srt' for timed subtitles.")
+    }),
+    execute: async ({ video_id, language, format }) => c.youtube.transcript({ video_id, language, format })
+  });
+}
+function scavioYoutubeComments(config) {
+  const c = client(config);
+  const max = config?.maxResults ?? 10;
+  return (0, import_ai.tool)({
+    description: "List comments on a YouTube video via the Scavio API.",
+    inputSchema: import_zod.z.object({
+      video_id: import_zod.z.string().describe("YouTube video id or a full watch URL."),
+      cursor: import_zod.z.string().optional().describe("Pagination cursor.")
+    }),
+    execute: async ({ video_id, cursor }) => trimData(
+      await c.youtube.comments({ video_id, cursor }),
+      "comments",
+      max
+    )
+  });
+}
+function scavioYoutubeChannel(config) {
+  const c = client(config);
+  return (0, import_ai.tool)({
+    description: "Fetch a YouTube channel's details (subscribers, video count, views, links) via the Scavio API.",
     inputSchema: import_zod.z.object({
-      query: import_zod.z.string().describe("The search query.")
+      channel_id: import_zod.z.string().describe("YouTube channel id, @handle, or channel URL.")
     }),
-    execute: async ({ query }) => trim(await c.youtube.search({ query }), max)
+    execute: async ({ channel_id }) => c.youtube.channel({ channel_id })
   });
 }
 function scavioRedditSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return (0, import_ai.tool)({
-    description: "Search Reddit posts and communities via the Scavio API.",
+    description: "Search Reddit posts via the Scavio API (1 credit). Returns matching posts under `data.results` with `data.next_cursor` for the next page. Results cannot be sorted or filtered by type.",
     inputSchema: import_zod.z.object({
       query: import_zod.z.string().describe("The search query."),
-      sort: import_zod.z.string().optional().describe("Sort order for results.")
+      cursor: import_zod.z.string().optional().describe("Pagination cursor (`next_cursor`) from a prior response.")
     }),
-    execute: async ({ query, sort }) => trim(await c.reddit.search({ query, sort }), max)
+    execute: async ({ query, cursor }) => trimData(await c.reddit.search({ query, cursor }), "results", max)
   });
 }
 function scavioAmazonSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return (0, import_ai.tool)({
-    description: "Search Amazon for products via the Scavio API.",
+    description: "Search Amazon for products via the Scavio API. Results are unsorted and cannot be filtered by category, merchant or price.",
     inputSchema: import_zod.z.object({
       query: import_zod.z.string().describe("The product search query."),
-      domain: import_zod.z.string().optional().describe('Amazon domain, e.g. "amazon.com".')
+      country: import_zod.z.string().optional().describe(
+        "Marketplace country code (ISO 3166-1 alpha-2), not a domain: us (default), gb (the UK is gb, not uk), de, fr, jp, ... An unknown code falls back to us."
+      )
+    }),
+    execute: async ({ query, country }) => trimData(await c.amazon.search({ query, country }), "products", max)
+  });
+}
+function scavioAmazonOffers(config) {
+  const c = client(config);
+  const max = config?.maxResults ?? 10;
+  return (0, import_ai.tool)({
+    description: "List every seller offer for one Amazon ASIN via the Scavio API: price, seller, condition, shipping, and which offer holds the buy box. Page 1 only.",
+    inputSchema: import_zod.z.object({
+      asin: import_zod.z.string().describe("Amazon Standard Identification Number (ASIN) of the product."),
+      country: import_zod.z.string().optional().describe(
+        "Marketplace country code (ISO 3166-1 alpha-2), not a domain: us (default), gb (the UK is gb, not uk), de, fr, jp, ... An unknown code falls back to us."
+      )
     }),
-    execute: async ({ query, domain }) => trim(await c.amazon.search({ query, domain }), max)
+    execute: async ({ asin, country }) => trimData(await c.amazon.offers({ asin, country }), "offers", max)
   });
 }
 function scavioWalmartSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return (0, import_ai.tool)({
-    description: "Search Walmart for products via the Scavio API.",
+    description: "Search Walmart for products via the Scavio API. Products come back under `data.products`.",
     inputSchema: import_zod.z.object({
       query: import_zod.z.string().describe("The product search query.")
     }),
-    execute: async ({ query }) => trim(await c.walmart.search({ query }), max)
+    execute: async ({ query }) => trimData(await c.walmart.search({ query }), "products", max)
   });
 }
 function scavioTiktokSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return (0, import_ai.tool)({
-    description: "Search TikTok for videos by keyword via the Scavio API.",
+    description: "Search TikTok for videos by keyword via the Scavio API. Videos come back under `data.aweme_list`.",
     inputSchema: import_zod.z.object({
       keyword: import_zod.z.string().describe("The search keyword."),
-      sort_type: import_zod.z.string().optional().describe("Sort order for results."),
-      publish_time: import_zod.z.string().optional().describe("Filter by publish time window.")
+      sort_type: import_zod.z.enum(["0", "1"]).optional().describe("Sort order: '0' relevance, '1' most likes."),
+      publish_time: import_zod.z.enum(["0", "1", "7", "30", "90", "180"]).optional().describe("Publish window in days: '0' all time, '1', '7', '30', '90', '180'.")
     }),
-    execute: async ({ keyword, sort_type, publish_time }) => trim(
+    execute: async ({ keyword, sort_type, publish_time }) => trimData(
       await c.tiktok.searchVideos({
         keyword,
         sort_type,
         publish_time
       }),
+      "aweme_list",
       max
     )
   });
@@ -144,19 +244,25 @@ function scavioInstagramSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return (0, import_ai.tool)({
-    description: "Search Instagram for users by keyword via the Scavio API.",
+    description: "Search Instagram for users by keyword via the Scavio API (10 credits). Users come back under `data.users`.",
     inputSchema: import_zod.z.object({
       keyword: import_zod.z.string().describe("The search keyword.")
     }),
-    execute: async ({ keyword }) => trim(await c.instagram.searchUsers({ keyword }), max)
+    execute: async ({ keyword }) => trimData(await c.instagram.searchUsers({ keyword }), "users", max)
   });
 }
 function scavioTools(config) {
   return {
+    scavio_extract: scavioExtract(config),
     scavio_search: scavioSearch(config),
     scavio_youtube_search: scavioYoutubeSearch(config),
+    scavio_youtube_video: scavioYoutubeVideo(config),
+    scavio_youtube_transcript: scavioYoutubeTranscript(config),
+    scavio_youtube_comments: scavioYoutubeComments(config),
+    scavio_youtube_channel: scavioYoutubeChannel(config),
     scavio_reddit_search: scavioRedditSearch(config),
     scavio_amazon_search: scavioAmazonSearch(config),
+    scavio_amazon_offers: scavioAmazonOffers(config),
     scavio_walmart_search: scavioWalmartSearch(config),
     scavio_tiktok_search: scavioTiktokSearch(config),
     scavio_instagram_search: scavioInstagramSearch(config)
@@ -164,13 +270,19 @@ function scavioTools(config) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  scavioAmazonOffers,
   scavioAmazonSearch,
+  scavioExtract,
   scavioInstagramSearch,
   scavioRedditSearch,
   scavioSearch,
   scavioTiktokSearch,
   scavioTools,
   scavioWalmartSearch,
-  scavioYoutubeSearch
+  scavioYoutubeChannel,
+  scavioYoutubeComments,
+  scavioYoutubeSearch,
+  scavioYoutubeTranscript,
+  scavioYoutubeVideo
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { Scavio, type ScavioConfig, type GoogleSearchOptions } from \"scavio\";\n\nexport interface ScavioToolConfig extends ScavioConfig {\n /** Max number of results to keep in `results`-style lists. Defaults to 10. /\n maxResults?: number;\n}\n\nfunction client(config?: ScavioToolConfig): Scavio {\n return new Scavio({ apiKey: config?.apiKey });\n}\n\nfunction trim(res: Record<string, unknown>, max: number): Record<string, unknown> {\n const results = res.results;\n if (Array.isArray(results) && results.length > max) {\n return { ...res, results: results.slice(0, max) };\n }\n return res;\n}\n\nfunction trimList(res: Record<string, unknown>, key: string, max: number): Record<string, unknown> {\n const list = res[key];\n if (Array.isArray(list) && list.length > max) {\n return { ...res, [key]: list.slice(0, max) };\n }\n return res;\n}\n\n/* Google web search (/api/v2/google, 1 credit). /\nexport function scavioSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search the web with Google via the Scavio API (1 credit). Returns real-time organic search results, each with a title, link, and snippet, under `organic_results`.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n countryCode: z.string().optional().describe('Two-letter country code to localize results, e.g. \"us\".'),\n language: z.string().optional().describe('Two-letter UI language code, e.g. \"en\".'),\n page: z.number().int().optional().describe(\"1-based result page; page 2 starts at result 10.\"),\n device: z.enum([\"desktop\", \"mobile\"]).optional().describe(\"Device to emulate.\"),\n nfpr: z.boolean().optional().describe(\"Disable spelling auto-correction / similar-result substitution when true.\"),\n }),\n execute: async ({ query, countryCode, language, page, device, nfpr }) => {\n const params: GoogleSearchOptions = { query };\n if (countryCode) params.gl = countryCode;\n if (language) params.hl = language;\n if (page && page > 1) params.start = (page - 1) 10;\n if (device) params.device = device;\n if (nfpr !== undefined) params.nfpr = nfpr;\n return trimList(await c.google.search(params), \"organic_results\", max);\n },\n });\n}\n\n/** YouTube video search. /\nexport function scavioYoutubeSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search YouTube for videos via the Scavio API.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n }),\n execute: async ({ query }) => trim(await c.youtube.search({ query }), max),\n });\n}\n\n/* Reddit post/community search (costs 2 credits). /\nexport function scavioRedditSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search Reddit posts and communities via the Scavio API.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n sort: z.string().optional().describe(\"Sort order for results.\"),\n }),\n execute: async ({ query, sort }) =>\n trim(await c.reddit.search({ query, sort } as Parameters<typeof c.reddit.search>[0]), max),\n });\n}\n\n/* Amazon product search. /\nexport function scavioAmazonSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search Amazon for products via the Scavio API.\",\n inputSchema: z.object({\n query: z.string().describe(\"The product search query.\"),\n domain: z.string().optional().describe('Amazon domain, e.g. \"amazon.com\".'),\n }),\n execute: async ({ query, domain }) => trim(await c.amazon.search({ query, domain }), max),\n });\n}\n\n/* Walmart product search. /\nexport function scavioWalmartSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search Walmart for products via the Scavio API.\",\n inputSchema: z.object({\n query: z.string().describe(\"The product search query.\"),\n }),\n execute: async ({ query }) => trim(await c.walmart.search({ query }), max),\n });\n}\n\n/* TikTok video search. /\nexport function scavioTiktokSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search TikTok for videos by keyword via the Scavio API.\",\n inputSchema: z.object({\n keyword: z.string().describe(\"The search keyword.\"),\n sort_type: z.string().optional().describe(\"Sort order for results.\"),\n publish_time: z.string().optional().describe(\"Filter by publish time window.\"),\n }),\n execute: async ({ keyword, sort_type, publish_time }) =>\n trim(\n await c.tiktok.searchVideos({\n keyword,\n sort_type,\n publish_time,\n } as Parameters<typeof c.tiktok.searchVideos>[0]),\n max,\n ),\n });\n}\n\n/* Instagram user search. /\nexport function scavioInstagramSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search Instagram for users by keyword via the Scavio API.\",\n inputSchema: z.object({\n keyword: z.string().describe(\"The search keyword.\"),\n }),\n execute: async ({ keyword }) => trim(await c.instagram.searchUsers({ keyword }), max),\n });\n}\n\n/\n All Scavio tools as an object keyed by tool name, ready to spread into the\n * `tools` option of `generateText` / `streamText`.\n */\nexport function scavioTools(config?: ScavioToolConfig) {\n return {\n scavio_search: scavioSearch(config),\n scavio_youtube_search: scavioYoutubeSearch(config),\n scavio_reddit_search: scavioRedditSearch(config),\n scavio_amazon_search: scavioAmazonSearch(config),\n scavio_walmart_search: scavioWalmartSearch(config),\n scavio_tiktok_search: scavioTiktokSearch(config),\n scavio_instagram_search: scavioInstagramSearch(config),\n };\n}\n"],"mappings":"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","names":[]}
1	+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { Scavio, type ScavioConfig, type GoogleSearchOptions } from \"scavio\";\n\nexport interface ScavioToolConfig extends ScavioConfig {\n /*\n Max number of items to keep in the tool's result list. Defaults to 10.\n * Trimmed inside `data` on every platform except Google, whose body is flat.\n * Ignored by `scavioExtract`, which returns page content rather than a list.\n /\n maxResults?: number;\n}\n\nfunction client(config?: ScavioToolConfig): Scavio {\n return new Scavio({ apiKey: config?.apiKey });\n}\n\n/\n Google is the ONLY family with a flat body: `organic_results` and friends sit\n * at the top level, next to `response_time` / `credits_used` / `credits_remaining`.\n /\nfunction trimFlat(res: Record<string, unknown>, key: string, max: number): Record<string, unknown> {\n const list = res[key];\n if (Array.isArray(list) && list.length > max) {\n return { ...res, [key]: list.slice(0, max) };\n }\n return res;\n}\n\n/\n Every non-Google endpoint nests its payload under `data` - the response is\n * `{ data: { products: [...] }, response_time, credits_used, credits_remaining }`.\n * Trimming the top level is therefore a silent no-op, so those tools trim\n * inside `data`.\n /\nfunction trimData(res: Record<string, unknown>, key: string, max: number): Record<string, unknown> {\n const data = res.data;\n if (!data \|\| typeof data !== \"object\") return res;\n const list = (data as Record<string, unknown>)[key];\n if (Array.isArray(list) && list.length > max) {\n return { ...res, data: { ...(data as Record<string, unknown>), [key]: list.slice(0, max) } };\n }\n return res;\n}\n\n/\n Read any URL (/api/v1/extract).\n \n The one tool here that is not tied to a platform, and the only one `maxResults`\n * does not touch: extract returns page CONTENT, not a result list, so there is\n * nothing to trim and the body is returned whole. `extract` is a TOP-LEVEL\n * method on the SDK client - `c.extract({ url })`, never `c.extract.extract()`.\n \n Credits are a function of `mode`, not a per-call constant: \"normal\" 1,\n * \"advanced\" 1, \"ultra\" 2. Only a successful read is billed.\n /\nexport function scavioExtract(config?: ScavioToolConfig) {\n const c = client(config);\n return tool({\n description:\n \"Read any web page via the Scavio API and get it back as clean Markdown (default), plain text, or raw HTML. Use it on any URL, including one returned by the search tools. Returns `data.content` alongside `data.url`, `data.format`, `data.mode` and `data.content_length`. Cost depends on `mode`: 1 credit on 'normal' and 'advanced', 2 on 'ultra'; a dead link, bot wall or timeout is not billed.\",\n inputSchema: z.object({\n url: z\n .string()\n .describe(\n \"The 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.\",\n ),\n format: z\n .enum([\"html\", \"markdown\", \"text\"])\n .optional()\n .describe(\n \"Output format (default 'markdown'): 'markdown' is a readability extraction with page chrome stripped, 'text' is that flattened to plain text, 'html' is the raw page.\",\n ),\n mode: z\n .enum([\"normal\", \"advanced\", \"ultra\"])\n .optional()\n .describe(\n \"Fetch tier, and the parameter that sets the price: 'normal' (default) is a plain fetch and costs 1 credit, 'advanced' renders the page in a browser for JS-built sites and costs 1, 'ultra' routes through residential proxies for the hardest bot walls and costs 2. Start on 'normal'.\",\n ),\n }),\n execute: async ({ url, format, mode }) => c.extract({ url, format, mode }),\n });\n}\n\n/* Google web search (/api/v2/google, 1 credit). /\nexport function scavioSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search the web with Google via the Scavio API (1 credit). Returns real-time organic search results, each with a title, link, and snippet, under `organic_results`.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n countryCode: z.string().optional().describe('Two-letter country code to localize results, e.g. \"us\".'),\n language: z.string().optional().describe('Two-letter UI language code, e.g. \"en\".'),\n page: z.number().int().optional().describe(\"1-based result page; page 2 starts at result 10.\"),\n device: z.enum([\"desktop\", \"mobile\"]).optional().describe(\"Device to emulate.\"),\n nfpr: z.boolean().optional().describe(\"Disable spelling auto-correction / similar-result substitution when true.\"),\n }),\n execute: async ({ query, countryCode, language, page, device, nfpr }) => {\n const params: GoogleSearchOptions = { query };\n if (countryCode) params.gl = countryCode;\n if (language) params.hl = language;\n if (page && page > 1) params.start = (page - 1) 10;\n if (device) params.device = device;\n if (nfpr !== undefined) params.nfpr = nfpr;\n return trimFlat(await c.google.search(params), \"organic_results\", max);\n },\n });\n}\n\n/** YouTube video search (2 credits). /\nexport function scavioYoutubeSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search YouTube for videos, channels, or playlists via the Scavio API (2 credits). Videos come back under `data.results`, with `data.channels` and `data.playlists` alongside.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n upload_date: z.string().optional().describe(\"Upload date filter, e.g. 'today', 'this_week', 'this_month'.\"),\n type: z.string().optional().describe(\"Result type: 'video', 'channel', 'playlist', 'movie'.\"),\n duration: z.string().optional().describe(\"Duration filter: 'short', 'medium', 'long'.\"),\n sort_by: z.string().optional().describe(\"Sort order: 'relevance', 'date', 'view_count', 'rating'.\"),\n cursor: z.string().optional().describe(\"Pagination cursor (`next_cursor`) from a prior response.\"),\n }),\n execute: async ({ query, upload_date, type, duration, sort_by, cursor }) =>\n trimData(\n await c.youtube.search({ query, upload_date, type, duration, sort_by, cursor } as Parameters<\n typeof c.youtube.search\n >[0]),\n \"results\",\n max,\n ),\n });\n}\n\n/* YouTube video details (1 credit). /\nexport function scavioYoutubeVideo(config?: ScavioToolConfig) {\n const c = client(config);\n return tool({\n description:\n \"Fetch full details for a YouTube video (title, author, view count, description, captions, chapters) via the Scavio API.\",\n inputSchema: z.object({\n video_id: z.string().describe(\"YouTube video id or a full watch URL.\"),\n }),\n execute: async ({ video_id }) => c.youtube.video({ video_id }),\n });\n}\n\n/* YouTube video transcript / subtitles (8 credits). /\nexport function scavioYoutubeTranscript(config?: ScavioToolConfig) {\n const c = client(config);\n return tool({\n description:\n \"Fetch a YouTube video's transcript or timed subtitles via the Scavio API (8 credits).\",\n inputSchema: z.object({\n video_id: z.string().describe(\"YouTube video id or a full watch URL.\"),\n language: z.string().optional().describe(\"Transcript language code (default 'en').\"),\n format: z.enum([\"text\", \"srt\"]).optional().describe(\"'text' for a plain transcript, 'srt' for timed subtitles.\"),\n }),\n execute: async ({ video_id, language, format }) =>\n c.youtube.transcript({ video_id, language, format } as Parameters<typeof c.youtube.transcript>[0]),\n });\n}\n\n/* YouTube video comments (1 credit). /\nexport function scavioYoutubeComments(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"List comments on a YouTube video via the Scavio API.\",\n inputSchema: z.object({\n video_id: z.string().describe(\"YouTube video id or a full watch URL.\"),\n cursor: z.string().optional().describe(\"Pagination cursor.\"),\n }),\n execute: async ({ video_id, cursor }) =>\n trimData(\n await c.youtube.comments({ video_id, cursor } as Parameters<typeof c.youtube.comments>[0]),\n \"comments\",\n max,\n ),\n });\n}\n\n/* YouTube channel details (1 credit). /\nexport function scavioYoutubeChannel(config?: ScavioToolConfig) {\n const c = client(config);\n return tool({\n description:\n \"Fetch a YouTube channel's details (subscribers, video count, views, links) via the Scavio API.\",\n inputSchema: z.object({\n channel_id: z.string().describe(\"YouTube channel id, @handle, or channel URL.\"),\n }),\n execute: async ({ channel_id }) => c.youtube.channel({ channel_id }),\n });\n}\n\n/\n Reddit post search (1 credit).\n \n The endpoint takes `query` and `cursor` and nothing else - it cannot sort or\n * filter by type, so no such input is offered. The API silently ignores those\n * params, which would leave a model believing it had filtered when it had not.\n /\nexport function scavioRedditSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search Reddit posts via the Scavio API (1 credit). Returns matching posts under `data.results` with `data.next_cursor` for the next page. Results cannot be sorted or filtered by type.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n cursor: z.string().optional().describe(\"Pagination cursor (`next_cursor`) from a prior response.\"),\n }),\n execute: async ({ query, cursor }) => trimData(await c.reddit.search({ query, cursor }), \"results\", max),\n });\n}\n\n/\n Amazon product search.\n \n `domain` was dropped in favour of `country`, a two-letter marketplace code -\n * the upstream provider changed in 2026-07 and no longer takes a domain\n * suffix. It still works on the wire as a deprecated alias, but a model should\n * only ever see one spelling of a param.\n /\nexport function scavioAmazonSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search Amazon for products via the Scavio API. Results are unsorted and cannot be filtered by category, merchant or price.\",\n inputSchema: z.object({\n query: z.string().describe(\"The product search query.\"),\n country: z\n .string()\n .optional()\n .describe(\n \"Marketplace country code (ISO 3166-1 alpha-2), not a domain: us (default), gb (the UK is gb, not uk), de, fr, jp, ... An unknown code falls back to us.\"\n ),\n }),\n execute: async ({ query, country }) =>\n trimData(await c.amazon.search({ query, country }), \"products\", max),\n });\n}\n\n/* Every seller offer for one Amazon ASIN. /\nexport function scavioAmazonOffers(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"List every seller offer for one Amazon ASIN via the Scavio API: price, seller, condition, shipping, and which offer holds the buy box. Page 1 only.\",\n inputSchema: z.object({\n asin: z.string().describe(\"Amazon Standard Identification Number (ASIN) of the product.\"),\n country: z\n .string()\n .optional()\n .describe(\n \"Marketplace country code (ISO 3166-1 alpha-2), not a domain: us (default), gb (the UK is gb, not uk), de, fr, jp, ... An unknown code falls back to us.\"\n ),\n }),\n execute: async ({ asin, country }) =>\n trimData(await c.amazon.offers({ asin, country }), \"offers\", max),\n });\n}\n\n/* Walmart product search. /\nexport function scavioWalmartSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search Walmart for products via the Scavio API. Products come back under `data.products`.\",\n inputSchema: z.object({\n query: z.string().describe(\"The product search query.\"),\n }),\n execute: async ({ query }) => trimData(await c.walmart.search({ query }), \"products\", max),\n });\n}\n\n/* TikTok video search. /\nexport function scavioTiktokSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search TikTok for videos by keyword via the Scavio API. Videos come back under `data.aweme_list`.\",\n inputSchema: z.object({\n keyword: z.string().describe(\"The search keyword.\"),\n sort_type: z.enum([\"0\", \"1\"]).optional().describe(\"Sort order: '0' relevance, '1' most likes.\"),\n publish_time: z\n .enum([\"0\", \"1\", \"7\", \"30\", \"90\", \"180\"])\n .optional()\n .describe(\"Publish window in days: '0' all time, '1', '7', '30', '90', '180'.\"),\n }),\n execute: async ({ keyword, sort_type, publish_time }) =>\n trimData(\n await c.tiktok.searchVideos({\n keyword,\n sort_type,\n publish_time,\n } as Parameters<typeof c.tiktok.searchVideos>[0]),\n \"aweme_list\",\n max,\n ),\n });\n}\n\n/* Instagram user search. /\nexport function scavioInstagramSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search Instagram for users by keyword via the Scavio API (10 credits). Users come back under `data.users`.\",\n inputSchema: z.object({\n keyword: z.string().describe(\"The search keyword.\"),\n }),\n execute: async ({ keyword }) => trimData(await c.instagram.searchUsers({ keyword }), \"users\", max),\n });\n}\n\n/\n All Scavio tools as an object keyed by tool name, ready to spread into the\n * `tools` option of `generateText` / `streamText`.\n */\nexport function scavioTools(config?: ScavioToolConfig) {\n return {\n scavio_extract: scavioExtract(config),\n scavio_search: scavioSearch(config),\n scavio_youtube_search: scavioYoutubeSearch(config),\n scavio_youtube_video: scavioYoutubeVideo(config),\n scavio_youtube_transcript: scavioYoutubeTranscript(config),\n scavio_youtube_comments: scavioYoutubeComments(config),\n scavio_youtube_channel: scavioYoutubeChannel(config),\n scavio_reddit_search: scavioRedditSearch(config),\n scavio_amazon_search: scavioAmazonSearch(config),\n scavio_amazon_offers: scavioAmazonOffers(config),\n scavio_walmart_search: scavioWalmartSearch(config),\n scavio_tiktok_search: scavioTiktokSearch(config),\n scavio_instagram_search: scavioInstagramSearch(config),\n };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts CHANGED Viewed

@@ -2,9 +2,29 @@ import * as ai from 'ai';
 import { ScavioConfig } from 'scavio';
 interface ScavioToolConfig extends ScavioConfig {
-    /** Max number of results to keep in `results`-style lists. Defaults to 10. */
+    /**
+     * Max number of items to keep in the tool's result list. Defaults to 10.
+     * Trimmed inside `data` on every platform except Google, whose body is flat.
+     * Ignored by `scavioExtract`, which returns page content rather than a list.
+     */
     maxResults?: number;
 }
+/**
+ * Read any URL (/api/v1/extract).
+ *
+ * The one tool here that is not tied to a platform, and the only one `maxResults`
+ * does not touch: extract returns page CONTENT, not a result list, so there is
+ * nothing to trim and the body is returned whole. `extract` is a TOP-LEVEL
+ * method on the SDK client - `c.extract({ url })`, never `c.extract.extract()`.
+ *
+ * Credits are a function of `mode`, not a per-call constant: "normal" 1,
+ * "advanced" 1, "ultra" 2. Only a successful read is billed.
+ */
+declare function scavioExtract(config?: ScavioToolConfig): ai.Tool<{
+    url: string;
+    format?: "html" | "markdown" | "text" | undefined;
+    mode?: "normal" | "advanced" | "ultra" | undefined;
+}, Record<string, unknown>>;
 /** Google web search (/api/v2/google, 1 credit). */
 declare function scavioSearch(config?: ScavioToolConfig): ai.Tool<{
     query: string;
@@ -14,19 +34,61 @@ declare function scavioSearch(config?: ScavioToolConfig): ai.Tool<{
     device?: "desktop" | "mobile" | undefined;
     nfpr?: boolean | undefined;
 }, Record<string, unknown>>;
-/** YouTube video search. */
+/** YouTube video search (2 credits). */
 declare function scavioYoutubeSearch(config?: ScavioToolConfig): ai.Tool<{
     query: string;
+    type?: string | undefined;
+    upload_date?: string | undefined;
+    duration?: string | undefined;
+    sort_by?: string | undefined;
+    cursor?: string | undefined;
+}, Record<string, unknown>>;
+/** YouTube video details (1 credit). */
+declare function scavioYoutubeVideo(config?: ScavioToolConfig): ai.Tool<{
+    video_id: string;
+}, Record<string, unknown>>;
+/** YouTube video transcript / subtitles (8 credits). */
+declare function scavioYoutubeTranscript(config?: ScavioToolConfig): ai.Tool<{
+    video_id: string;
+    format?: "text" | "srt" | undefined;
+    language?: string | undefined;
+}, Record<string, unknown>>;
+/** YouTube video comments (1 credit). */
+declare function scavioYoutubeComments(config?: ScavioToolConfig): ai.Tool<{
+    video_id: string;
+    cursor?: string | undefined;
+}, Record<string, unknown>>;
+/** YouTube channel details (1 credit). */
+declare function scavioYoutubeChannel(config?: ScavioToolConfig): ai.Tool<{
+    channel_id: string;
 }, Record<string, unknown>>;
-/** Reddit post/community search (costs 2 credits). */
+/**
+ * Reddit post search (1 credit).
+ *
+ * The endpoint takes `query` and `cursor` and nothing else - it cannot sort or
+ * filter by type, so no such input is offered. The API silently ignores those
+ * params, which would leave a model believing it had filtered when it had not.
+ */
 declare function scavioRedditSearch(config?: ScavioToolConfig): ai.Tool<{
     query: string;
-    sort?: string | undefined;
+    cursor?: string | undefined;
 }, Record<string, unknown>>;
-/** Amazon product search. */
+/**
+ * Amazon product search.
+ *
+ * `domain` was dropped in favour of `country`, a two-letter marketplace code -
+ * the upstream provider changed in 2026-07 and no longer takes a domain
+ * suffix. It still works on the wire as a deprecated alias, but a model should
+ * only ever see one spelling of a param.
+ */
 declare function scavioAmazonSearch(config?: ScavioToolConfig): ai.Tool<{
     query: string;
-    domain?: string | undefined;
+    country?: string | undefined;
+}, Record<string, unknown>>;
+/** Every seller offer for one Amazon ASIN. */
+declare function scavioAmazonOffers(config?: ScavioToolConfig): ai.Tool<{
+    asin: string;
+    country?: string | undefined;
 }, Record<string, unknown>>;
 /** Walmart product search. */
 declare function scavioWalmartSearch(config?: ScavioToolConfig): ai.Tool<{
@@ -35,8 +97,8 @@ declare function scavioWalmartSearch(config?: ScavioToolConfig): ai.Tool<{
 /** TikTok video search. */
 declare function scavioTiktokSearch(config?: ScavioToolConfig): ai.Tool<{
     keyword: string;
-    sort_type?: string | undefined;
-    publish_time?: string | undefined;
+    sort_type?: "0" | "1" | undefined;
+    publish_time?: "0" | "1" | "7" | "30" | "90" | "180" | undefined;
 }, Record<string, unknown>>;
 /** Instagram user search. */
 declare function scavioInstagramSearch(config?: ScavioToolConfig): ai.Tool<{
@@ -47,6 +109,11 @@ declare function scavioInstagramSearch(config?: ScavioToolConfig): ai.Tool<{
  * `tools` option of `generateText` / `streamText`.
  */
 declare function scavioTools(config?: ScavioToolConfig): {
+    scavio_extract: ai.Tool<{
+        url: string;
+        format?: "html" | "markdown" | "text" | undefined;
+        mode?: "normal" | "advanced" | "ultra" | undefined;
+    }, Record<string, unknown>>;
     scavio_search: ai.Tool<{
         query: string;
         countryCode?: string | undefined;
@@ -57,26 +124,50 @@ declare function scavioTools(config?: ScavioToolConfig): {
     }, Record<string, unknown>>;
     scavio_youtube_search: ai.Tool<{
         query: string;
+        type?: string | undefined;
+        upload_date?: string | undefined;
+        duration?: string | undefined;
+        sort_by?: string | undefined;
+        cursor?: string | undefined;
+    }, Record<string, unknown>>;
+    scavio_youtube_video: ai.Tool<{
+        video_id: string;
+    }, Record<string, unknown>>;
+    scavio_youtube_transcript: ai.Tool<{
+        video_id: string;
+        format?: "text" | "srt" | undefined;
+        language?: string | undefined;
+    }, Record<string, unknown>>;
+    scavio_youtube_comments: ai.Tool<{
+        video_id: string;
+        cursor?: string | undefined;
+    }, Record<string, unknown>>;
+    scavio_youtube_channel: ai.Tool<{
+        channel_id: string;
     }, Record<string, unknown>>;
     scavio_reddit_search: ai.Tool<{
         query: string;
-        sort?: string | undefined;
+        cursor?: string | undefined;
     }, Record<string, unknown>>;
     scavio_amazon_search: ai.Tool<{
         query: string;
-        domain?: string | undefined;
+        country?: string | undefined;
+    }, Record<string, unknown>>;
+    scavio_amazon_offers: ai.Tool<{
+        asin: string;
+        country?: string | undefined;
     }, Record<string, unknown>>;
     scavio_walmart_search: ai.Tool<{
         query: string;
     }, Record<string, unknown>>;
     scavio_tiktok_search: ai.Tool<{
         keyword: string;
-        sort_type?: string | undefined;
-        publish_time?: string | undefined;
+        sort_type?: "0" | "1" | undefined;
+        publish_time?: "0" | "1" | "7" | "30" | "90" | "180" | undefined;
     }, Record<string, unknown>>;
     scavio_instagram_search: ai.Tool<{
         keyword: string;
     }, Record<string, unknown>>;
 };
-export { type ScavioToolConfig, scavioAmazonSearch, scavioInstagramSearch, scavioRedditSearch, scavioSearch, scavioTiktokSearch, scavioTools, scavioWalmartSearch, scavioYoutubeSearch };
+export { type ScavioToolConfig, scavioAmazonOffers, scavioAmazonSearch, scavioExtract, scavioInstagramSearch, scavioRedditSearch, scavioSearch, scavioTiktokSearch, scavioTools, scavioWalmartSearch, scavioYoutubeChannel, scavioYoutubeComments, scavioYoutubeSearch, scavioYoutubeTranscript, scavioYoutubeVideo };

package/dist/index.d.ts CHANGED Viewed

@@ -2,9 +2,29 @@ import * as ai from 'ai';
 import { ScavioConfig } from 'scavio';
 interface ScavioToolConfig extends ScavioConfig {
-    /** Max number of results to keep in `results`-style lists. Defaults to 10. */
+    /**
+     * Max number of items to keep in the tool's result list. Defaults to 10.
+     * Trimmed inside `data` on every platform except Google, whose body is flat.
+     * Ignored by `scavioExtract`, which returns page content rather than a list.
+     */
     maxResults?: number;
 }
+/**
+ * Read any URL (/api/v1/extract).
+ *
+ * The one tool here that is not tied to a platform, and the only one `maxResults`
+ * does not touch: extract returns page CONTENT, not a result list, so there is
+ * nothing to trim and the body is returned whole. `extract` is a TOP-LEVEL
+ * method on the SDK client - `c.extract({ url })`, never `c.extract.extract()`.
+ *
+ * Credits are a function of `mode`, not a per-call constant: "normal" 1,
+ * "advanced" 1, "ultra" 2. Only a successful read is billed.
+ */
+declare function scavioExtract(config?: ScavioToolConfig): ai.Tool<{
+    url: string;
+    format?: "html" | "markdown" | "text" | undefined;
+    mode?: "normal" | "advanced" | "ultra" | undefined;
+}, Record<string, unknown>>;
 /** Google web search (/api/v2/google, 1 credit). */
 declare function scavioSearch(config?: ScavioToolConfig): ai.Tool<{
     query: string;
@@ -14,19 +34,61 @@ declare function scavioSearch(config?: ScavioToolConfig): ai.Tool<{
     device?: "desktop" | "mobile" | undefined;
     nfpr?: boolean | undefined;
 }, Record<string, unknown>>;
-/** YouTube video search. */
+/** YouTube video search (2 credits). */
 declare function scavioYoutubeSearch(config?: ScavioToolConfig): ai.Tool<{
     query: string;
+    type?: string | undefined;
+    upload_date?: string | undefined;
+    duration?: string | undefined;
+    sort_by?: string | undefined;
+    cursor?: string | undefined;
+}, Record<string, unknown>>;
+/** YouTube video details (1 credit). */
+declare function scavioYoutubeVideo(config?: ScavioToolConfig): ai.Tool<{
+    video_id: string;
+}, Record<string, unknown>>;
+/** YouTube video transcript / subtitles (8 credits). */
+declare function scavioYoutubeTranscript(config?: ScavioToolConfig): ai.Tool<{
+    video_id: string;
+    format?: "text" | "srt" | undefined;
+    language?: string | undefined;
+}, Record<string, unknown>>;
+/** YouTube video comments (1 credit). */
+declare function scavioYoutubeComments(config?: ScavioToolConfig): ai.Tool<{
+    video_id: string;
+    cursor?: string | undefined;
+}, Record<string, unknown>>;
+/** YouTube channel details (1 credit). */
+declare function scavioYoutubeChannel(config?: ScavioToolConfig): ai.Tool<{
+    channel_id: string;
 }, Record<string, unknown>>;
-/** Reddit post/community search (costs 2 credits). */
+/**
+ * Reddit post search (1 credit).
+ *
+ * The endpoint takes `query` and `cursor` and nothing else - it cannot sort or
+ * filter by type, so no such input is offered. The API silently ignores those
+ * params, which would leave a model believing it had filtered when it had not.
+ */
 declare function scavioRedditSearch(config?: ScavioToolConfig): ai.Tool<{
     query: string;
-    sort?: string | undefined;
+    cursor?: string | undefined;
 }, Record<string, unknown>>;
-/** Amazon product search. */
+/**
+ * Amazon product search.
+ *
+ * `domain` was dropped in favour of `country`, a two-letter marketplace code -
+ * the upstream provider changed in 2026-07 and no longer takes a domain
+ * suffix. It still works on the wire as a deprecated alias, but a model should
+ * only ever see one spelling of a param.
+ */
 declare function scavioAmazonSearch(config?: ScavioToolConfig): ai.Tool<{
     query: string;
-    domain?: string | undefined;
+    country?: string | undefined;
+}, Record<string, unknown>>;
+/** Every seller offer for one Amazon ASIN. */
+declare function scavioAmazonOffers(config?: ScavioToolConfig): ai.Tool<{
+    asin: string;
+    country?: string | undefined;
 }, Record<string, unknown>>;
 /** Walmart product search. */
 declare function scavioWalmartSearch(config?: ScavioToolConfig): ai.Tool<{
@@ -35,8 +97,8 @@ declare function scavioWalmartSearch(config?: ScavioToolConfig): ai.Tool<{
 /** TikTok video search. */
 declare function scavioTiktokSearch(config?: ScavioToolConfig): ai.Tool<{
     keyword: string;
-    sort_type?: string | undefined;
-    publish_time?: string | undefined;
+    sort_type?: "0" | "1" | undefined;
+    publish_time?: "0" | "1" | "7" | "30" | "90" | "180" | undefined;
 }, Record<string, unknown>>;
 /** Instagram user search. */
 declare function scavioInstagramSearch(config?: ScavioToolConfig): ai.Tool<{
@@ -47,6 +109,11 @@ declare function scavioInstagramSearch(config?: ScavioToolConfig): ai.Tool<{
  * `tools` option of `generateText` / `streamText`.
  */
 declare function scavioTools(config?: ScavioToolConfig): {
+    scavio_extract: ai.Tool<{
+        url: string;
+        format?: "html" | "markdown" | "text" | undefined;
+        mode?: "normal" | "advanced" | "ultra" | undefined;
+    }, Record<string, unknown>>;
     scavio_search: ai.Tool<{
         query: string;
         countryCode?: string | undefined;
@@ -57,26 +124,50 @@ declare function scavioTools(config?: ScavioToolConfig): {
     }, Record<string, unknown>>;
     scavio_youtube_search: ai.Tool<{
         query: string;
+        type?: string | undefined;
+        upload_date?: string | undefined;
+        duration?: string | undefined;
+        sort_by?: string | undefined;
+        cursor?: string | undefined;
+    }, Record<string, unknown>>;
+    scavio_youtube_video: ai.Tool<{
+        video_id: string;
+    }, Record<string, unknown>>;
+    scavio_youtube_transcript: ai.Tool<{
+        video_id: string;
+        format?: "text" | "srt" | undefined;
+        language?: string | undefined;
+    }, Record<string, unknown>>;
+    scavio_youtube_comments: ai.Tool<{
+        video_id: string;
+        cursor?: string | undefined;
+    }, Record<string, unknown>>;
+    scavio_youtube_channel: ai.Tool<{
+        channel_id: string;
     }, Record<string, unknown>>;
     scavio_reddit_search: ai.Tool<{
         query: string;
-        sort?: string | undefined;
+        cursor?: string | undefined;
     }, Record<string, unknown>>;
     scavio_amazon_search: ai.Tool<{
         query: string;
-        domain?: string | undefined;
+        country?: string | undefined;
+    }, Record<string, unknown>>;
+    scavio_amazon_offers: ai.Tool<{
+        asin: string;
+        country?: string | undefined;
     }, Record<string, unknown>>;
     scavio_walmart_search: ai.Tool<{
         query: string;
     }, Record<string, unknown>>;
     scavio_tiktok_search: ai.Tool<{
         keyword: string;
-        sort_type?: string | undefined;
-        publish_time?: string | undefined;
+        sort_type?: "0" | "1" | undefined;
+        publish_time?: "0" | "1" | "7" | "30" | "90" | "180" | undefined;
     }, Record<string, unknown>>;
     scavio_instagram_search: ai.Tool<{
         keyword: string;
     }, Record<string, unknown>>;
 };
-export { type ScavioToolConfig, scavioAmazonSearch, scavioInstagramSearch, scavioRedditSearch, scavioSearch, scavioTiktokSearch, scavioTools, scavioWalmartSearch, scavioYoutubeSearch };
+export { type ScavioToolConfig, scavioAmazonOffers, scavioAmazonSearch, scavioExtract, scavioInstagramSearch, scavioRedditSearch, scavioSearch, scavioTiktokSearch, scavioTools, scavioWalmartSearch, scavioYoutubeChannel, scavioYoutubeComments, scavioYoutubeSearch, scavioYoutubeTranscript, scavioYoutubeVideo };

package/dist/index.js CHANGED Viewed

@@ -5,20 +5,40 @@ import { Scavio } from "scavio";
 function client(config) {
   return new Scavio({ apiKey: config?.apiKey });
 }
-function trim(res, max) {
-  const results = res.results;
-  if (Array.isArray(results) && results.length > max) {
-    return { ...res, results: results.slice(0, max) };
+function trimFlat(res, key, max) {
+  const list = res[key];
+  if (Array.isArray(list) && list.length > max) {
+    return { ...res, [key]: list.slice(0, max) };
   }
   return res;
 }
-function trimList(res, key, max) {
-  const list = res[key];
+function trimData(res, key, max) {
+  const data = res.data;
+  if (!data || typeof data !== "object") return res;
+  const list = data[key];
   if (Array.isArray(list) && list.length > max) {
-    return { ...res, [key]: list.slice(0, max) };
+    return { ...res, data: { ...data, [key]: list.slice(0, max) } };
   }
   return res;
 }
+function scavioExtract(config) {
+  const c = client(config);
+  return tool({
+    description: "Read any web page via the Scavio API and get it back as clean Markdown (default), plain text, or raw HTML. Use it on any URL, including one returned by the search tools. Returns `data.content` alongside `data.url`, `data.format`, `data.mode` and `data.content_length`. Cost depends on `mode`: 1 credit on 'normal' and 'advanced', 2 on 'ultra'; a dead link, bot wall or timeout is not billed.",
+    inputSchema: z.object({
+      url: z.string().describe(
+        "The 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."
+      ),
+      format: z.enum(["html", "markdown", "text"]).optional().describe(
+        "Output format (default 'markdown'): 'markdown' is a readability extraction with page chrome stripped, 'text' is that flattened to plain text, 'html' is the raw page."
+      ),
+      mode: z.enum(["normal", "advanced", "ultra"]).optional().describe(
+        "Fetch tier, and the parameter that sets the price: 'normal' (default) is a plain fetch and costs 1 credit, 'advanced' renders the page in a browser for JS-built sites and costs 1, 'ultra' routes through residential proxies for the hardest bot walls and costs 2. Start on 'normal'."
+      )
+    }),
+    execute: async ({ url, format, mode }) => c.extract({ url, format, mode })
+  });
+}
 function scavioSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
@@ -39,7 +59,7 @@ function scavioSearch(config) {
       if (page && page > 1) params.start = (page - 1) * 10;
       if (device) params.device = device;
       if (nfpr !== void 0) params.nfpr = nfpr;
-      return trimList(await c.google.search(params), "organic_results", max);
+      return trimFlat(await c.google.search(params), "organic_results", max);
     }
   });
 }
@@ -47,64 +67,138 @@ function scavioYoutubeSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return tool({
-    description: "Search YouTube for videos via the Scavio API.",
+    description: "Search YouTube for videos, channels, or playlists via the Scavio API (2 credits). Videos come back under `data.results`, with `data.channels` and `data.playlists` alongside.",
+    inputSchema: z.object({
+      query: z.string().describe("The search query."),
+      upload_date: z.string().optional().describe("Upload date filter, e.g. 'today', 'this_week', 'this_month'."),
+      type: z.string().optional().describe("Result type: 'video', 'channel', 'playlist', 'movie'."),
+      duration: z.string().optional().describe("Duration filter: 'short', 'medium', 'long'."),
+      sort_by: z.string().optional().describe("Sort order: 'relevance', 'date', 'view_count', 'rating'."),
+      cursor: z.string().optional().describe("Pagination cursor (`next_cursor`) from a prior response.")
+    }),
+    execute: async ({ query, upload_date, type, duration, sort_by, cursor }) => trimData(
+      await c.youtube.search({ query, upload_date, type, duration, sort_by, cursor }),
+      "results",
+      max
+    )
+  });
+}
+function scavioYoutubeVideo(config) {
+  const c = client(config);
+  return tool({
+    description: "Fetch full details for a YouTube video (title, author, view count, description, captions, chapters) via the Scavio API.",
+    inputSchema: z.object({
+      video_id: z.string().describe("YouTube video id or a full watch URL.")
+    }),
+    execute: async ({ video_id }) => c.youtube.video({ video_id })
+  });
+}
+function scavioYoutubeTranscript(config) {
+  const c = client(config);
+  return tool({
+    description: "Fetch a YouTube video's transcript or timed subtitles via the Scavio API (8 credits).",
+    inputSchema: z.object({
+      video_id: z.string().describe("YouTube video id or a full watch URL."),
+      language: z.string().optional().describe("Transcript language code (default 'en')."),
+      format: z.enum(["text", "srt"]).optional().describe("'text' for a plain transcript, 'srt' for timed subtitles.")
+    }),
+    execute: async ({ video_id, language, format }) => c.youtube.transcript({ video_id, language, format })
+  });
+}
+function scavioYoutubeComments(config) {
+  const c = client(config);
+  const max = config?.maxResults ?? 10;
+  return tool({
+    description: "List comments on a YouTube video via the Scavio API.",
+    inputSchema: z.object({
+      video_id: z.string().describe("YouTube video id or a full watch URL."),
+      cursor: z.string().optional().describe("Pagination cursor.")
+    }),
+    execute: async ({ video_id, cursor }) => trimData(
+      await c.youtube.comments({ video_id, cursor }),
+      "comments",
+      max
+    )
+  });
+}
+function scavioYoutubeChannel(config) {
+  const c = client(config);
+  return tool({
+    description: "Fetch a YouTube channel's details (subscribers, video count, views, links) via the Scavio API.",
     inputSchema: z.object({
-      query: z.string().describe("The search query.")
+      channel_id: z.string().describe("YouTube channel id, @handle, or channel URL.")
     }),
-    execute: async ({ query }) => trim(await c.youtube.search({ query }), max)
+    execute: async ({ channel_id }) => c.youtube.channel({ channel_id })
   });
 }
 function scavioRedditSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return tool({
-    description: "Search Reddit posts and communities via the Scavio API.",
+    description: "Search Reddit posts via the Scavio API (1 credit). Returns matching posts under `data.results` with `data.next_cursor` for the next page. Results cannot be sorted or filtered by type.",
     inputSchema: z.object({
       query: z.string().describe("The search query."),
-      sort: z.string().optional().describe("Sort order for results.")
+      cursor: z.string().optional().describe("Pagination cursor (`next_cursor`) from a prior response.")
     }),
-    execute: async ({ query, sort }) => trim(await c.reddit.search({ query, sort }), max)
+    execute: async ({ query, cursor }) => trimData(await c.reddit.search({ query, cursor }), "results", max)
   });
 }
 function scavioAmazonSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return tool({
-    description: "Search Amazon for products via the Scavio API.",
+    description: "Search Amazon for products via the Scavio API. Results are unsorted and cannot be filtered by category, merchant or price.",
     inputSchema: z.object({
       query: z.string().describe("The product search query."),
-      domain: z.string().optional().describe('Amazon domain, e.g. "amazon.com".')
+      country: z.string().optional().describe(
+        "Marketplace country code (ISO 3166-1 alpha-2), not a domain: us (default), gb (the UK is gb, not uk), de, fr, jp, ... An unknown code falls back to us."
+      )
+    }),
+    execute: async ({ query, country }) => trimData(await c.amazon.search({ query, country }), "products", max)
+  });
+}
+function scavioAmazonOffers(config) {
+  const c = client(config);
+  const max = config?.maxResults ?? 10;
+  return tool({
+    description: "List every seller offer for one Amazon ASIN via the Scavio API: price, seller, condition, shipping, and which offer holds the buy box. Page 1 only.",
+    inputSchema: z.object({
+      asin: z.string().describe("Amazon Standard Identification Number (ASIN) of the product."),
+      country: z.string().optional().describe(
+        "Marketplace country code (ISO 3166-1 alpha-2), not a domain: us (default), gb (the UK is gb, not uk), de, fr, jp, ... An unknown code falls back to us."
+      )
     }),
-    execute: async ({ query, domain }) => trim(await c.amazon.search({ query, domain }), max)
+    execute: async ({ asin, country }) => trimData(await c.amazon.offers({ asin, country }), "offers", max)
   });
 }
 function scavioWalmartSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return tool({
-    description: "Search Walmart for products via the Scavio API.",
+    description: "Search Walmart for products via the Scavio API. Products come back under `data.products`.",
     inputSchema: z.object({
       query: z.string().describe("The product search query.")
     }),
-    execute: async ({ query }) => trim(await c.walmart.search({ query }), max)
+    execute: async ({ query }) => trimData(await c.walmart.search({ query }), "products", max)
   });
 }
 function scavioTiktokSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return tool({
-    description: "Search TikTok for videos by keyword via the Scavio API.",
+    description: "Search TikTok for videos by keyword via the Scavio API. Videos come back under `data.aweme_list`.",
     inputSchema: z.object({
       keyword: z.string().describe("The search keyword."),
-      sort_type: z.string().optional().describe("Sort order for results."),
-      publish_time: z.string().optional().describe("Filter by publish time window.")
+      sort_type: z.enum(["0", "1"]).optional().describe("Sort order: '0' relevance, '1' most likes."),
+      publish_time: z.enum(["0", "1", "7", "30", "90", "180"]).optional().describe("Publish window in days: '0' all time, '1', '7', '30', '90', '180'.")
     }),
-    execute: async ({ keyword, sort_type, publish_time }) => trim(
+    execute: async ({ keyword, sort_type, publish_time }) => trimData(
       await c.tiktok.searchVideos({
         keyword,
         sort_type,
         publish_time
       }),
+      "aweme_list",
       max
     )
   });
@@ -113,32 +207,44 @@ function scavioInstagramSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return tool({
-    description: "Search Instagram for users by keyword via the Scavio API.",
+    description: "Search Instagram for users by keyword via the Scavio API (10 credits). Users come back under `data.users`.",
     inputSchema: z.object({
       keyword: z.string().describe("The search keyword.")
     }),
-    execute: async ({ keyword }) => trim(await c.instagram.searchUsers({ keyword }), max)
+    execute: async ({ keyword }) => trimData(await c.instagram.searchUsers({ keyword }), "users", max)
   });
 }
 function scavioTools(config) {
   return {
+    scavio_extract: scavioExtract(config),
     scavio_search: scavioSearch(config),
     scavio_youtube_search: scavioYoutubeSearch(config),
+    scavio_youtube_video: scavioYoutubeVideo(config),
+    scavio_youtube_transcript: scavioYoutubeTranscript(config),
+    scavio_youtube_comments: scavioYoutubeComments(config),
+    scavio_youtube_channel: scavioYoutubeChannel(config),
     scavio_reddit_search: scavioRedditSearch(config),
     scavio_amazon_search: scavioAmazonSearch(config),
+    scavio_amazon_offers: scavioAmazonOffers(config),
     scavio_walmart_search: scavioWalmartSearch(config),
     scavio_tiktok_search: scavioTiktokSearch(config),
     scavio_instagram_search: scavioInstagramSearch(config)
   };
 }
 export {
+  scavioAmazonOffers,
   scavioAmazonSearch,
+  scavioExtract,
   scavioInstagramSearch,
   scavioRedditSearch,
   scavioSearch,
   scavioTiktokSearch,
   scavioTools,
   scavioWalmartSearch,
-  scavioYoutubeSearch
+  scavioYoutubeChannel,
+  scavioYoutubeComments,
+  scavioYoutubeSearch,
+  scavioYoutubeTranscript,
+  scavioYoutubeVideo
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { Scavio, type ScavioConfig, type GoogleSearchOptions } from \"scavio\";\n\nexport interface ScavioToolConfig extends ScavioConfig {\n /** Max number of results to keep in `results`-style lists. Defaults to 10. /\n maxResults?: number;\n}\n\nfunction client(config?: ScavioToolConfig): Scavio {\n return new Scavio({ apiKey: config?.apiKey });\n}\n\nfunction trim(res: Record<string, unknown>, max: number): Record<string, unknown> {\n const results = res.results;\n if (Array.isArray(results) && results.length > max) {\n return { ...res, results: results.slice(0, max) };\n }\n return res;\n}\n\nfunction trimList(res: Record<string, unknown>, key: string, max: number): Record<string, unknown> {\n const list = res[key];\n if (Array.isArray(list) && list.length > max) {\n return { ...res, [key]: list.slice(0, max) };\n }\n return res;\n}\n\n/* Google web search (/api/v2/google, 1 credit). /\nexport function scavioSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search the web with Google via the Scavio API (1 credit). Returns real-time organic search results, each with a title, link, and snippet, under `organic_results`.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n countryCode: z.string().optional().describe('Two-letter country code to localize results, e.g. \"us\".'),\n language: z.string().optional().describe('Two-letter UI language code, e.g. \"en\".'),\n page: z.number().int().optional().describe(\"1-based result page; page 2 starts at result 10.\"),\n device: z.enum([\"desktop\", \"mobile\"]).optional().describe(\"Device to emulate.\"),\n nfpr: z.boolean().optional().describe(\"Disable spelling auto-correction / similar-result substitution when true.\"),\n }),\n execute: async ({ query, countryCode, language, page, device, nfpr }) => {\n const params: GoogleSearchOptions = { query };\n if (countryCode) params.gl = countryCode;\n if (language) params.hl = language;\n if (page && page > 1) params.start = (page - 1) 10;\n if (device) params.device = device;\n if (nfpr !== undefined) params.nfpr = nfpr;\n return trimList(await c.google.search(params), \"organic_results\", max);\n },\n });\n}\n\n/** YouTube video search. /\nexport function scavioYoutubeSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search YouTube for videos via the Scavio API.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n }),\n execute: async ({ query }) => trim(await c.youtube.search({ query }), max),\n });\n}\n\n/* Reddit post/community search (costs 2 credits). /\nexport function scavioRedditSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search Reddit posts and communities via the Scavio API.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n sort: z.string().optional().describe(\"Sort order for results.\"),\n }),\n execute: async ({ query, sort }) =>\n trim(await c.reddit.search({ query, sort } as Parameters<typeof c.reddit.search>[0]), max),\n });\n}\n\n/* Amazon product search. /\nexport function scavioAmazonSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search Amazon for products via the Scavio API.\",\n inputSchema: z.object({\n query: z.string().describe(\"The product search query.\"),\n domain: z.string().optional().describe('Amazon domain, e.g. \"amazon.com\".'),\n }),\n execute: async ({ query, domain }) => trim(await c.amazon.search({ query, domain }), max),\n });\n}\n\n/* Walmart product search. /\nexport function scavioWalmartSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search Walmart for products via the Scavio API.\",\n inputSchema: z.object({\n query: z.string().describe(\"The product search query.\"),\n }),\n execute: async ({ query }) => trim(await c.walmart.search({ query }), max),\n });\n}\n\n/* TikTok video search. /\nexport function scavioTiktokSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search TikTok for videos by keyword via the Scavio API.\",\n inputSchema: z.object({\n keyword: z.string().describe(\"The search keyword.\"),\n sort_type: z.string().optional().describe(\"Sort order for results.\"),\n publish_time: z.string().optional().describe(\"Filter by publish time window.\"),\n }),\n execute: async ({ keyword, sort_type, publish_time }) =>\n trim(\n await c.tiktok.searchVideos({\n keyword,\n sort_type,\n publish_time,\n } as Parameters<typeof c.tiktok.searchVideos>[0]),\n max,\n ),\n });\n}\n\n/* Instagram user search. /\nexport function scavioInstagramSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search Instagram for users by keyword via the Scavio API.\",\n inputSchema: z.object({\n keyword: z.string().describe(\"The search keyword.\"),\n }),\n execute: async ({ keyword }) => trim(await c.instagram.searchUsers({ keyword }), max),\n });\n}\n\n/\n All Scavio tools as an object keyed by tool name, ready to spread into the\n * `tools` option of `generateText` / `streamText`.\n */\nexport function scavioTools(config?: ScavioToolConfig) {\n return {\n scavio_search: scavioSearch(config),\n scavio_youtube_search: scavioYoutubeSearch(config),\n scavio_reddit_search: scavioRedditSearch(config),\n scavio_amazon_search: scavioAmazonSearch(config),\n scavio_walmart_search: scavioWalmartSearch(config),\n scavio_tiktok_search: scavioTiktokSearch(config),\n scavio_instagram_search: scavioInstagramSearch(config),\n };\n}\n"],"mappings":"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","names":[]}
1	+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { Scavio, type ScavioConfig, type GoogleSearchOptions } from \"scavio\";\n\nexport interface ScavioToolConfig extends ScavioConfig {\n /*\n Max number of items to keep in the tool's result list. Defaults to 10.\n * Trimmed inside `data` on every platform except Google, whose body is flat.\n * Ignored by `scavioExtract`, which returns page content rather than a list.\n /\n maxResults?: number;\n}\n\nfunction client(config?: ScavioToolConfig): Scavio {\n return new Scavio({ apiKey: config?.apiKey });\n}\n\n/\n Google is the ONLY family with a flat body: `organic_results` and friends sit\n * at the top level, next to `response_time` / `credits_used` / `credits_remaining`.\n /\nfunction trimFlat(res: Record<string, unknown>, key: string, max: number): Record<string, unknown> {\n const list = res[key];\n if (Array.isArray(list) && list.length > max) {\n return { ...res, [key]: list.slice(0, max) };\n }\n return res;\n}\n\n/\n Every non-Google endpoint nests its payload under `data` - the response is\n * `{ data: { products: [...] }, response_time, credits_used, credits_remaining }`.\n * Trimming the top level is therefore a silent no-op, so those tools trim\n * inside `data`.\n /\nfunction trimData(res: Record<string, unknown>, key: string, max: number): Record<string, unknown> {\n const data = res.data;\n if (!data \|\| typeof data !== \"object\") return res;\n const list = (data as Record<string, unknown>)[key];\n if (Array.isArray(list) && list.length > max) {\n return { ...res, data: { ...(data as Record<string, unknown>), [key]: list.slice(0, max) } };\n }\n return res;\n}\n\n/\n Read any URL (/api/v1/extract).\n \n The one tool here that is not tied to a platform, and the only one `maxResults`\n * does not touch: extract returns page CONTENT, not a result list, so there is\n * nothing to trim and the body is returned whole. `extract` is a TOP-LEVEL\n * method on the SDK client - `c.extract({ url })`, never `c.extract.extract()`.\n \n Credits are a function of `mode`, not a per-call constant: \"normal\" 1,\n * \"advanced\" 1, \"ultra\" 2. Only a successful read is billed.\n /\nexport function scavioExtract(config?: ScavioToolConfig) {\n const c = client(config);\n return tool({\n description:\n \"Read any web page via the Scavio API and get it back as clean Markdown (default), plain text, or raw HTML. Use it on any URL, including one returned by the search tools. Returns `data.content` alongside `data.url`, `data.format`, `data.mode` and `data.content_length`. Cost depends on `mode`: 1 credit on 'normal' and 'advanced', 2 on 'ultra'; a dead link, bot wall or timeout is not billed.\",\n inputSchema: z.object({\n url: z\n .string()\n .describe(\n \"The 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.\",\n ),\n format: z\n .enum([\"html\", \"markdown\", \"text\"])\n .optional()\n .describe(\n \"Output format (default 'markdown'): 'markdown' is a readability extraction with page chrome stripped, 'text' is that flattened to plain text, 'html' is the raw page.\",\n ),\n mode: z\n .enum([\"normal\", \"advanced\", \"ultra\"])\n .optional()\n .describe(\n \"Fetch tier, and the parameter that sets the price: 'normal' (default) is a plain fetch and costs 1 credit, 'advanced' renders the page in a browser for JS-built sites and costs 1, 'ultra' routes through residential proxies for the hardest bot walls and costs 2. Start on 'normal'.\",\n ),\n }),\n execute: async ({ url, format, mode }) => c.extract({ url, format, mode }),\n });\n}\n\n/* Google web search (/api/v2/google, 1 credit). /\nexport function scavioSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search the web with Google via the Scavio API (1 credit). Returns real-time organic search results, each with a title, link, and snippet, under `organic_results`.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n countryCode: z.string().optional().describe('Two-letter country code to localize results, e.g. \"us\".'),\n language: z.string().optional().describe('Two-letter UI language code, e.g. \"en\".'),\n page: z.number().int().optional().describe(\"1-based result page; page 2 starts at result 10.\"),\n device: z.enum([\"desktop\", \"mobile\"]).optional().describe(\"Device to emulate.\"),\n nfpr: z.boolean().optional().describe(\"Disable spelling auto-correction / similar-result substitution when true.\"),\n }),\n execute: async ({ query, countryCode, language, page, device, nfpr }) => {\n const params: GoogleSearchOptions = { query };\n if (countryCode) params.gl = countryCode;\n if (language) params.hl = language;\n if (page && page > 1) params.start = (page - 1) 10;\n if (device) params.device = device;\n if (nfpr !== undefined) params.nfpr = nfpr;\n return trimFlat(await c.google.search(params), \"organic_results\", max);\n },\n });\n}\n\n/** YouTube video search (2 credits). /\nexport function scavioYoutubeSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search YouTube for videos, channels, or playlists via the Scavio API (2 credits). Videos come back under `data.results`, with `data.channels` and `data.playlists` alongside.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n upload_date: z.string().optional().describe(\"Upload date filter, e.g. 'today', 'this_week', 'this_month'.\"),\n type: z.string().optional().describe(\"Result type: 'video', 'channel', 'playlist', 'movie'.\"),\n duration: z.string().optional().describe(\"Duration filter: 'short', 'medium', 'long'.\"),\n sort_by: z.string().optional().describe(\"Sort order: 'relevance', 'date', 'view_count', 'rating'.\"),\n cursor: z.string().optional().describe(\"Pagination cursor (`next_cursor`) from a prior response.\"),\n }),\n execute: async ({ query, upload_date, type, duration, sort_by, cursor }) =>\n trimData(\n await c.youtube.search({ query, upload_date, type, duration, sort_by, cursor } as Parameters<\n typeof c.youtube.search\n >[0]),\n \"results\",\n max,\n ),\n });\n}\n\n/* YouTube video details (1 credit). /\nexport function scavioYoutubeVideo(config?: ScavioToolConfig) {\n const c = client(config);\n return tool({\n description:\n \"Fetch full details for a YouTube video (title, author, view count, description, captions, chapters) via the Scavio API.\",\n inputSchema: z.object({\n video_id: z.string().describe(\"YouTube video id or a full watch URL.\"),\n }),\n execute: async ({ video_id }) => c.youtube.video({ video_id }),\n });\n}\n\n/* YouTube video transcript / subtitles (8 credits). /\nexport function scavioYoutubeTranscript(config?: ScavioToolConfig) {\n const c = client(config);\n return tool({\n description:\n \"Fetch a YouTube video's transcript or timed subtitles via the Scavio API (8 credits).\",\n inputSchema: z.object({\n video_id: z.string().describe(\"YouTube video id or a full watch URL.\"),\n language: z.string().optional().describe(\"Transcript language code (default 'en').\"),\n format: z.enum([\"text\", \"srt\"]).optional().describe(\"'text' for a plain transcript, 'srt' for timed subtitles.\"),\n }),\n execute: async ({ video_id, language, format }) =>\n c.youtube.transcript({ video_id, language, format } as Parameters<typeof c.youtube.transcript>[0]),\n });\n}\n\n/* YouTube video comments (1 credit). /\nexport function scavioYoutubeComments(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"List comments on a YouTube video via the Scavio API.\",\n inputSchema: z.object({\n video_id: z.string().describe(\"YouTube video id or a full watch URL.\"),\n cursor: z.string().optional().describe(\"Pagination cursor.\"),\n }),\n execute: async ({ video_id, cursor }) =>\n trimData(\n await c.youtube.comments({ video_id, cursor } as Parameters<typeof c.youtube.comments>[0]),\n \"comments\",\n max,\n ),\n });\n}\n\n/* YouTube channel details (1 credit). /\nexport function scavioYoutubeChannel(config?: ScavioToolConfig) {\n const c = client(config);\n return tool({\n description:\n \"Fetch a YouTube channel's details (subscribers, video count, views, links) via the Scavio API.\",\n inputSchema: z.object({\n channel_id: z.string().describe(\"YouTube channel id, @handle, or channel URL.\"),\n }),\n execute: async ({ channel_id }) => c.youtube.channel({ channel_id }),\n });\n}\n\n/\n Reddit post search (1 credit).\n \n The endpoint takes `query` and `cursor` and nothing else - it cannot sort or\n * filter by type, so no such input is offered. The API silently ignores those\n * params, which would leave a model believing it had filtered when it had not.\n /\nexport function scavioRedditSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search Reddit posts via the Scavio API (1 credit). Returns matching posts under `data.results` with `data.next_cursor` for the next page. Results cannot be sorted or filtered by type.\",\n inputSchema: z.object({\n query: z.string().describe(\"The search query.\"),\n cursor: z.string().optional().describe(\"Pagination cursor (`next_cursor`) from a prior response.\"),\n }),\n execute: async ({ query, cursor }) => trimData(await c.reddit.search({ query, cursor }), \"results\", max),\n });\n}\n\n/\n Amazon product search.\n \n `domain` was dropped in favour of `country`, a two-letter marketplace code -\n * the upstream provider changed in 2026-07 and no longer takes a domain\n * suffix. It still works on the wire as a deprecated alias, but a model should\n * only ever see one spelling of a param.\n /\nexport function scavioAmazonSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search Amazon for products via the Scavio API. Results are unsorted and cannot be filtered by category, merchant or price.\",\n inputSchema: z.object({\n query: z.string().describe(\"The product search query.\"),\n country: z\n .string()\n .optional()\n .describe(\n \"Marketplace country code (ISO 3166-1 alpha-2), not a domain: us (default), gb (the UK is gb, not uk), de, fr, jp, ... An unknown code falls back to us.\"\n ),\n }),\n execute: async ({ query, country }) =>\n trimData(await c.amazon.search({ query, country }), \"products\", max),\n });\n}\n\n/* Every seller offer for one Amazon ASIN. /\nexport function scavioAmazonOffers(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"List every seller offer for one Amazon ASIN via the Scavio API: price, seller, condition, shipping, and which offer holds the buy box. Page 1 only.\",\n inputSchema: z.object({\n asin: z.string().describe(\"Amazon Standard Identification Number (ASIN) of the product.\"),\n country: z\n .string()\n .optional()\n .describe(\n \"Marketplace country code (ISO 3166-1 alpha-2), not a domain: us (default), gb (the UK is gb, not uk), de, fr, jp, ... An unknown code falls back to us.\"\n ),\n }),\n execute: async ({ asin, country }) =>\n trimData(await c.amazon.offers({ asin, country }), \"offers\", max),\n });\n}\n\n/* Walmart product search. /\nexport function scavioWalmartSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description: \"Search Walmart for products via the Scavio API. Products come back under `data.products`.\",\n inputSchema: z.object({\n query: z.string().describe(\"The product search query.\"),\n }),\n execute: async ({ query }) => trimData(await c.walmart.search({ query }), \"products\", max),\n });\n}\n\n/* TikTok video search. /\nexport function scavioTiktokSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search TikTok for videos by keyword via the Scavio API. Videos come back under `data.aweme_list`.\",\n inputSchema: z.object({\n keyword: z.string().describe(\"The search keyword.\"),\n sort_type: z.enum([\"0\", \"1\"]).optional().describe(\"Sort order: '0' relevance, '1' most likes.\"),\n publish_time: z\n .enum([\"0\", \"1\", \"7\", \"30\", \"90\", \"180\"])\n .optional()\n .describe(\"Publish window in days: '0' all time, '1', '7', '30', '90', '180'.\"),\n }),\n execute: async ({ keyword, sort_type, publish_time }) =>\n trimData(\n await c.tiktok.searchVideos({\n keyword,\n sort_type,\n publish_time,\n } as Parameters<typeof c.tiktok.searchVideos>[0]),\n \"aweme_list\",\n max,\n ),\n });\n}\n\n/* Instagram user search. /\nexport function scavioInstagramSearch(config?: ScavioToolConfig) {\n const c = client(config);\n const max = config?.maxResults ?? 10;\n return tool({\n description:\n \"Search Instagram for users by keyword via the Scavio API (10 credits). Users come back under `data.users`.\",\n inputSchema: z.object({\n keyword: z.string().describe(\"The search keyword.\"),\n }),\n execute: async ({ keyword }) => trimData(await c.instagram.searchUsers({ keyword }), \"users\", max),\n });\n}\n\n/\n All Scavio tools as an object keyed by tool name, ready to spread into the\n * `tools` option of `generateText` / `streamText`.\n */\nexport function scavioTools(config?: ScavioToolConfig) {\n return {\n scavio_extract: scavioExtract(config),\n scavio_search: scavioSearch(config),\n scavio_youtube_search: scavioYoutubeSearch(config),\n scavio_youtube_video: scavioYoutubeVideo(config),\n scavio_youtube_transcript: scavioYoutubeTranscript(config),\n scavio_youtube_comments: scavioYoutubeComments(config),\n scavio_youtube_channel: scavioYoutubeChannel(config),\n scavio_reddit_search: scavioRedditSearch(config),\n scavio_amazon_search: scavioAmazonSearch(config),\n scavio_amazon_offers: scavioAmazonOffers(config),\n scavio_walmart_search: scavioWalmartSearch(config),\n scavio_tiktok_search: scavioTiktokSearch(config),\n scavio_instagram_search: scavioInstagramSearch(config),\n };\n}\n"],"mappings":"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","names":[]}

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@scavio/ai-sdk",
-  "version": "0.2.2",
-  "description": "Scavio search tools for the Vercel AI SDK (Google, YouTube, Reddit, Amazon, Walmart, TikTok, Instagram).",
+  "version": "0.4.0",
+  "description": "Scavio search and URL-extraction tools for the Vercel AI SDK (extract any URL, plus Google, YouTube, Reddit, Amazon, Walmart, TikTok, Instagram).",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -32,6 +32,8 @@
     "vercel-ai-sdk",
     "tools",
     "search",
+    "extract",
+    "web-scraping",
     "agents"
   ],
   "license": "MIT",
@@ -48,12 +50,12 @@
     "zod": ">=3"
   },
   "dependencies": {
-    "scavio": "^0.5.0"
+    "scavio": "^0.15.0"
   },
   "devDependencies": {
     "@ai-sdk/openai": "^3.0.74",
     "ai": "^6.0.208",
-    "scavio": "^0.5.0",
+    "scavio": "^0.15.0",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
     "vitest": "^2.0.0",