composio-scavio 0.5.1 → 0.5.3

package/README.md

@@ -31,7 +31,7 @@ Scavio is a single Search API over 31 platforms -- Google, YouTube, Amazon, Walm
 > result offset, not a page number** (0 is page 1, 10 is page 2), and there is no
 > `page` argument mapped onto it -- a silent remap fetches the wrong page.
 
-> **Amazon changed (breaking).** The upstream provider moved in 2026-07:
+> **Amazon changed (breaking).** The Amazon endpoint changed in 2026-07:
 > `domain` is replaced by `country`, a two-letter marketplace code (`us`, `gb`
 > -- the UK is `gb`, not `uk` -- `de`, `jp`, ...), and `sort_by`, `pages`,
 > `category_id`, `merchant_id`, `language`, `currency`, `device`, `zip_code`

package/dist/index.cjs

@@ -992,7 +992,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_PROFILE",
         "Scavio Instagram Profile",
-        "Fetch an Instagram profile by username or user id. Costs 10 credits.",
+        "Fetch an Instagram profile by username or user id. Costs 1 credit.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username.")
@@ -1002,7 +1002,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_POSTS",
         "Scavio Instagram User Posts",
-        "List an Instagram user's posts. Costs 2 credits, the cheapest Instagram endpoint.",
+        "List an Instagram user's posts. Costs 2 credits per page.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username."),
@@ -1014,7 +1014,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_REELS",
         "Scavio Instagram User Reels",
-        "List an Instagram user's reels. Costs 10 credits.",
+        "List an Instagram user's reels. Costs 1 credit (2 the first time a username is looked up).",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username."),
@@ -1026,7 +1026,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_TAGGED",
         "Scavio Instagram User Tagged",
-        "List posts an Instagram user is tagged in. Costs 10 credits.",
+        "List posts an Instagram user is tagged in. Costs 1 credit (2 the first time a username is looked up).",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username."),
@@ -1038,7 +1038,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_STORIES",
         "Scavio Instagram User Stories",
-        "Fetch an Instagram user's current stories. Costs 10 credits.",
+        "Fetch an Instagram user's current stories. Costs 2 credits.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username.")
@@ -1048,7 +1048,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_POST",
         "Scavio Instagram Post",
-        "Fetch an Instagram post by URL, media id, or shortcode. Costs 8 credits.",
+        "Fetch an Instagram post by URL, media id, or shortcode. Costs 2 credits.",
         import_zod.z.object({
           url: ostr("Post URL. Provide one of url, media_id, or shortcode."),
           media_id: ostr("Post media id. Provide one of url, media_id, or shortcode."),
@@ -1059,7 +1059,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_POST_COMMENTS",
         "Scavio Instagram Post Comments",
-        "List comments on an Instagram post by shortcode or URL. Costs 10 credits.",
+        "List comments on an Instagram post by shortcode or URL. Costs 2 credits per page.",
         import_zod.z.object({
           shortcode: ostr("Post shortcode. Provide this or url."),
           url: ostr("Post URL. Provide this or shortcode."),
@@ -1071,7 +1071,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_COMMENT_REPLIES",
         "Scavio Instagram Comment Replies",
-        "List replies to an Instagram post comment. Costs 8 credits.",
+        "List replies to an Instagram post comment. Costs 2 credits.",
         import_zod.z.object({
           media_id: str("Post media id."),
           comment_id: str("Parent comment id."),
@@ -1082,7 +1082,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_SEARCH_USERS",
         "Scavio Instagram Search Users",
-        "Search Instagram users by keyword. Costs 10 credits.",
+        "Search Instagram users by keyword. Costs 2 credits; a request with a cursor costs 8.",
         import_zod.z.object({
           keyword: str("Search keyword."),
           cursor: ostr("Pagination cursor.")
@@ -1092,7 +1092,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_SEARCH_HASHTAGS",
         "Scavio Instagram Search Hashtags",
-        "Search Instagram hashtags by keyword. Costs 10 credits.",
+        "Search Instagram hashtags by keyword. Costs 2 credits; a request with a cursor costs 8.",
         import_zod.z.object({
           keyword: str("Search keyword."),
           cursor: ostr("Pagination cursor.")
@@ -1102,7 +1102,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_FOLLOWERS",
         "Scavio Instagram User Followers",
-        "List an Instagram user's followers. Costs 10 credits.",
+        "List an Instagram user's followers. Costs 2 credits per page.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username."),
@@ -1114,7 +1114,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "INSTAGRAM_USER_FOLLOWINGS",
         "Scavio Instagram User Followings",
-        "List the accounts an Instagram user follows. Costs 10 credits.",
+        "List the accounts an Instagram user follows. Costs 2 credits per page.",
         import_zod.z.object({
           username: ostr("Instagram username. Provide this or user_id."),
           user_id: ostr("Instagram user id. Provide this or username."),
@@ -1247,7 +1247,7 @@ function buildScavioToolkit(options = {}) {
       tool(
         "LINKEDIN_PERSON_ABOUT",
         "Scavio LinkedIn Person About",
-        "The about-only slice of a LinkedIn profile: about, headline, education_summary, experiences, educations, honors_and_awards and bio_links. Same upstream call as LINKEDIN_PERSON, shaped down. Costs 1 credit.",
+        "The about-only slice of a LinkedIn profile: about, headline, education_summary, experiences, educations, honors_and_awards and bio_links. Same lookup as LINKEDIN_PERSON, shaped down. Costs 1 credit.",
         import_zod.z.object({
           username: ostr("Public identifier / vanity handle. Provide this or url."),
           url: ostr("Full LinkedIn profile URL. Provide this or username.")
@@ -1547,7 +1547,7 @@ function buildScavioToolkit(options = {}) {
           query: ostr("Keyword to search (1-500 characters). Optional: a seller-only search pages that seller's whole catalogue."),
           seller: ostr("Restrict results to one seller's listings (1-64 characters), as in ebay.com/usr/<name>. Can be sent with no query."),
           page: onum("Results page, 1-based."),
-          sort_by: ostr("Result sort order. Defaults to 'best_match'. eBay's 'Distance: nearest first' is deliberately unsupported (it ranks against our proxy exit, not the caller). Accepted values: 'best_match', 'ending_soonest', 'newly_listed', 'price_low', 'price_high'."),
+          sort_by: ostr("Result sort order. Defaults to 'best_match'. eBay's 'Distance: nearest first' is deliberately unsupported (it would not rank by the location of the caller). Accepted values: 'best_match', 'ending_soonest', 'newly_listed', 'price_low', 'price_high'."),
           min_price: onum("Minimum price, inclusive. Must be 0 or greater."),
           max_price: onum("Maximum price, inclusive. Must be 0 or greater."),
           condition: ostr("Item condition filter. 'refurbished' is eBay's parent condition, not one of its three graded tiers. Accepted values: 'new', 'open_box', 'refurbished', 'used', 'for_parts'."),
@@ -1750,7 +1750,7 @@ function buildScavioToolkit(options = {}) {
           adults: onum("Adult guests, >= 1 (default 2)."),
           children_ages: oarrnum("AGES of accompanying children, each 0-17, max 10 entries. Ages, not a count."),
           rooms: onum("Rooms required, >= 1 (default 1)."),
-          currency: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking prices off the proxy exit and identical requests disagree.")
+          currency: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking picks a currency itself and identical requests can disagree.")
         }),
         (i) => client.booking.search(i)
       ),
@@ -1766,7 +1766,7 @@ function buildScavioToolkit(options = {}) {
           adults: onum("Adult guests, >= 1 (default 2)."),
           children_ages: oarrnum("AGES of accompanying children, each 0-17, max 10 entries. Ages, not a count."),
           rooms: onum("Rooms required, >= 1 (default 1)."),
-          currency: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking prices off the proxy exit and identical requests disagree.")
+          currency: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Booking picks a currency itself and identical requests can disagree.")
         }),
         (i) => client.booking.hotel(i)
       ),
@@ -1912,7 +1912,7 @@ function buildScavioToolkit(options = {}) {
           guest_favorite: obool("Guest Favorite listings only."),
           free_cancellation: obool("Listings with free cancellation only."),
           amenities: ostr("Comma-separated amenities (1-200 characters): wifi, air_conditioning, pool, kitchen, free_parking, washer, self_check_in, tv, or raw numeric Airbnb amenity ids. An unrecognised NAME is rejected before the scrape."),
-          currency: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Airbnb prices off the proxy exit and identical requests disagree."),
+          currency: ostr("ISO 4217 currency for prices, 3 letters (default 'USD'). Without it Airbnb picks a currency itself and identical requests can disagree."),
           page: onum("Results page, 1-based. 18 listings per page. Cannot be combined with cursor."),
           cursor: ostr("next_cursor from a previous response (1-500 characters); wins over page, so sending both is rejected.")
         }),
@@ -1975,7 +1975,7 @@ function buildScavioToolkit(options = {}) {
         "Scavio Glassdoor Reviews",
         "Up to THREE full Glassdoor reviews - the cap is Glassdoor's login wall - with per-axis scores, pros, cons, advice, job title, location, employment status and employer response, plus complete rating statistics, star distribution, aggregate pro/con highlight terms and per-job-title review counts. There is no page param: move the window with category and employment_status. Provide employer_id or url. Costs 1 credit.",
         import_zod.z.object({
-          employer_id: ostr("Glassdoor employer id (1-50 characters): '1699', 'E1699' or 'IE1699'. Must be a STRING - a JSON number is rejected. Addressing by id costs two upstream fetches; the customer price is unchanged."),
+          employer_id: ostr("Glassdoor employer id (1-50 characters): '1699', 'E1699' or 'IE1699'. Must be a STRING - a JSON number is rejected. Addressing by id takes an extra lookup; the customer price is unchanged."),
           company: ostr("Employer name as it appears in a Glassdoor slug (1-200 characters). COSMETIC: ignored when url is set, and it does not satisfy the employer_id-or-url requirement."),
           url: ostr("Any glassdoor.com employer URL (1-500 characters). Pass back reviews_url from company() to skip the resolve fetch. A non-glassdoor.com host is rejected."),
           category: ostr("Restrict to reviews Glassdoor files under one topic. Closed enum: Glassdoor IGNORES an unknown value and serves the unfiltered set under a 200. Read filtered_review_count on the response to see how many match. Accepted values: 'career_development', 'compensation', 'culture', 'diversity_and_inclusion', 'management', 'work_life_balance'."),
@@ -1988,7 +1988,7 @@ function buildScavioToolkit(options = {}) {
         "Scavio Glassdoor Salaries",
         "Glassdoor salaries by job title, 10 titles per page: base-pay and total-pay percentiles P10-P90 with medians called out, sample counts, currency, pay period and last-reported date. The figures are Glassdoor's ESTIMATES for the title, not individual reported salaries. Provide employer_id or url. Costs 1 credit.",
         import_zod.z.object({
-          employer_id: ostr("Glassdoor employer id (1-50 characters): '1699', 'E1699' or 'IE1699'. Must be a STRING - a JSON number is rejected. Addressing by id costs two upstream fetches; the customer price is unchanged."),
+          employer_id: ostr("Glassdoor employer id (1-50 characters): '1699', 'E1699' or 'IE1699'. Must be a STRING - a JSON number is rejected. Addressing by id takes an extra lookup; the customer price is unchanged."),
           company: ostr("Employer name as it appears in a Glassdoor slug (1-200 characters). COSMETIC: ignored when url is set, and it does not satisfy the employer_id-or-url requirement."),
           url: ostr("Any glassdoor.com employer URL (1-500 characters). Pass back salaries_url from company() to skip the resolve fetch. A non-glassdoor.com host is rejected."),
           page: onum("Results page, 1-based. Ten job titles per page; page_count on the response is how many pages exist.")
@@ -2005,7 +2005,7 @@ function buildScavioToolkit(options = {}) {
         "Businesses in Yelp's ranked order: rating, review count, price band, categories, address, contact rails, hours, photos and a review snippet; every row carries both business_id and alias. Yelp fixes the page size at 10. Provide term and location, or url. Costs 2 credits.",
         import_zod.z.object({
           term: ostr("What to look for (1-200 characters): a category ('plumbers'), a dish, or a business name. Required together with location unless url is given."),
-          location: ostr("Where to look (1-200 characters): city and region, a full address, or a postcode. Effectively required - Yelp geolocates a location-less search off the proxy exit, so the same request answers about a different metro run to run."),
+          location: ostr("Where to look (1-200 characters): city and region, a full address, or a postcode. Effectively required - without it Yelp picks a location itself, so the same request can answer about a different metro run to run."),
           page: onum("Results page, 1-based. Yelp fixes the page size at 10."),
           sort: ostr("Result ordering (upstream default 'recommended'). Closed enum: Yelp IGNORES an unrecognised sortby and serves default ranking under a 200, billing a premium scrape for a sort that never ran. Accepted values: 'recommended', 'rating', 'review_count'."),
           price: oarrnum("Price bands to include, 1 ($) to 4 ($$$$); 1-4 values, combined freely - [1, 2] means $ or $$. Accepted values: 1, 2, 3, 4."),