mastra-scavio 0.1.1 → 0.3.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.
- package/README.md +16 -4
- package/dist/index.cjs +467 -77
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +61 -29
- package/dist/index.d.ts +61 -29
- package/dist/index.js +461 -77
- package/dist/index.js.map +1 -1
- package/package.json +14 -4
package/README.md
CHANGED
|
@@ -2,6 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
[Scavio](https://scavio.dev) real-time search tools for [Mastra](https://mastra.ai) agents — Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram, with one API key.
|
|
4
4
|
|
|
5
|
+
> **Amazon changed (breaking).** The upstream provider moved in 2026-07:
|
|
6
|
+
> `domain` is replaced by `country`, a two-letter marketplace code (`us`, `gb`
|
|
7
|
+
> -- the UK is `gb`, not `uk` -- `de`, `jp`, ...), and `sort_by`, `pages`,
|
|
8
|
+
> `category_id`, `merchant_id`, `language`, `currency`, `device`, `zip_code`
|
|
9
|
+
> and `autoselect_variant` are gone. The marketplace ignores all of them
|
|
10
|
+
> (`sort_by` returns the identical unordered set for every value), so they are
|
|
11
|
+
> removed rather than kept as silent no-ops. Rank and filter results yourself.
|
|
12
|
+
|
|
5
13
|
## Installation
|
|
6
14
|
|
|
7
15
|
```bash
|
|
@@ -10,7 +18,7 @@ npm install mastra-scavio @mastra/core zod
|
|
|
10
18
|
|
|
11
19
|
## Setup
|
|
12
20
|
|
|
13
|
-
Get a Scavio API key from the [Scavio Dashboard](https://dashboard.scavio.dev) (new accounts get free credits, no credit card). Set `SCAVIO_API_KEY` or pass `{ apiKey }`.
|
|
21
|
+
Get a Scavio API key from the [Scavio Dashboard](https://dashboard.scavio.dev) (new accounts get 50 free credits, no credit card). Set `SCAVIO_API_KEY` or pass `{ apiKey }`.
|
|
14
22
|
|
|
15
23
|
## Usage
|
|
16
24
|
|
|
@@ -42,10 +50,14 @@ const agent = new Agent({
|
|
|
42
50
|
|
|
43
51
|
## Tools
|
|
44
52
|
|
|
45
|
-
`createScavioTools()` returns: `scavioGoogleSearch`, `scavioAmazonSearch`, `scavioAmazonProduct`, `scavioWalmartSearch`, `scavioWalmartProduct`, `scavioYoutubeSearch`, `scavioYoutubeMetadata`, `scavioRedditSearch`, `scavioRedditPost`, `scavioTiktokSearch`, `scavioTiktokProfile`, `scavioInstagramSearch`, `scavioInstagramProfile`.
|
|
53
|
+
`createScavioTools()` returns: `scavioGoogleSearch`, `scavioAmazonSearch`, `scavioAmazonProduct`, `scavioAmazonOffers`, `scavioWalmartSearch`, `scavioWalmartProduct`, `scavioYoutubeSearch`, `scavioYoutubeVideo`, `scavioYoutubeMetadata`, `scavioYoutubeComments`, `scavioYoutubeChannel`, `scavioYoutubeTranscript`, `scavioYoutubeStreams`, `scavioRedditSearch`, `scavioRedditPost`, `scavioTiktokSearch`, `scavioTiktokProfile`, `scavioInstagramSearch`, `scavioInstagramProfile`.
|
|
54
|
+
|
|
55
|
+
Each tool returns the structured Scavio JSON response: `{ data, response_time, credits_used, credits_remaining }`, with the payload under `data` on every platform except Google, whose body is flat.
|
|
56
|
+
|
|
57
|
+
`scavioYoutubeMetadata` is a deprecated alias of `scavioYoutubeVideo` and is kept only for older agents - use `scavioYoutubeVideo`.
|
|
46
58
|
|
|
47
|
-
|
|
59
|
+
The full Scavio API - 98 endpoints across Google, YouTube, Amazon, Walmart, Reddit, TikTok, TikTok Shop, Instagram, X and LinkedIn - is also available directly via the [`scavio`](https://www.npmjs.com/package/scavio) SDK or the [MCP server](https://scavio.dev/docs).
|
|
48
60
|
|
|
49
61
|
## Credits
|
|
50
62
|
|
|
51
|
-
Most calls cost 1 credit, including Google
|
|
63
|
+
Most calls cost 1 credit, including Google and Reddit. YouTube search costs 2, YouTube streams 3, and YouTube transcript 8. The Instagram tools cost 10 each. See [scavio.dev/docs](https://scavio.dev/docs).
|