@oomol-lab/open-connector 1.9.0 → 1.9.2

package/src/providers/litescrape/apartments-schemas.js

@@ -0,0 +1,45 @@
+import { s } from "../../core/json-schema.js";
+export const apartmentsTools = [
+    {
+        name: "apartments_property",
+        path: "/api/apartments/property",
+        description: "Get an Apartments.com property by URL. This upstream API is Alpha.",
+        input: s.object("Apartments.com Property parameters.", {
+            url: s.string("Apartments.com property URL ending in its seven-character listing ID, without query parameters.\n\nAlpha: availability may vary by location or property. Returns available fields for the requested property. Prices may represent a rental range. Bedroom-specific rents and total-monthly-price labels are preserved when present.", { maxLength: 2048 }),
+        }, { required: ["url"] }),
+        asyncInput: s.object("Apartments.com Property asynchronous parameters.", {
+            url: s.string("Apartments.com property URL ending in its seven-character listing ID, without query parameters.\n\nAlpha: availability may vary by location or property. Returns available fields for the requested property. Prices may represent a rental range. Bedroom-specific rents and total-monthly-price labels are preserved when present.", { maxLength: 2048 }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["url"] }),
+        output: s.looseObject("Apartments.com Property response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            property: s.looseObject("property value.", {}),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "apartments_search",
+        path: "/api/apartments/search",
+        description: "Search Apartments.com listings from a search URL. This upstream API is Alpha.",
+        input: s.object("Apartments.com Search parameters.", {
+            url: s.string("Apartments.com location search URL, including any price, bedroom, amenity or page filters.\n\nAlpha: availability may vary by location or property. Use the site URL to set filters or select a page. Follow pagination.next when present. Page links and total counts are included when available. Prices may represent a rental range. Bedroom-specific rents and total-monthly-price labels are preserved when present.", { maxLength: 4096 }),
+        }, { required: ["url"] }),
+        asyncInput: s.object("Apartments.com Search asynchronous parameters.", {
+            url: s.string("Apartments.com location search URL, including any price, bedroom, amenity or page filters.\n\nAlpha: availability may vary by location or property. Use the site URL to set filters or select a page. Follow pagination.next when present. Page links and total counts are included when available. Prices may represent a rental range. Bedroom-specific rents and total-monthly-price labels are preserved when present.", { maxLength: 4096 }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["url"] }),
+        output: s.looseObject("Apartments.com Search response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            properties: s.array("properties value.", s.looseObject("properties value. item.", {})),
+            search_information: s.looseObject("search information value.", {}),
+            pagination: s.looseObject("pagination value.", {}),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

package/src/providers/litescrape/apple-schemas.d.ts

@@ -0,0 +1,2 @@
+import type { DataTool } from "./shared.ts";
+export declare const appleTools: DataTool[];

package/src/providers/litescrape/apple-schemas.js

@@ -0,0 +1,215 @@
+import { s } from "../../core/json-schema.js";
+export const appleTools = [
+    {
+        name: "apple_app_store_product",
+        path: "/api/apple/app-store/product",
+        description: "Get an App Store app's details, ratings and version history.",
+        input: s.object("Apple App Store Product parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            product_id: s.string("Positive decimal Apple app identifier, up to 20 digits.", {
+                pattern: "^[1-9][0-9]{0,19}$",
+            }),
+            type: s.literal("app", {
+                description: "App product type. Only app is supported.",
+            }),
+        }, { required: ["product_id"] }),
+        asyncInput: s.object("Apple App Store Product asynchronous parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            product_id: s.string("Positive decimal Apple app identifier, up to 20 digits.", {
+                pattern: "^[1-9][0-9]{0,19}$",
+            }),
+            type: s.literal("app", {
+                description: "App product type. Only app is supported.",
+            }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["product_id"] }),
+        output: s.looseObject("Apple App Store Product response.", {
+            age_rating: s.nullable(s.string("age rating value.")),
+            description: s.nullable(s.string("description value.")),
+            developer: s.nullable(s.looseObject("developer value.", {})),
+            featured_in: s.nullable(s.array("featured in value.", s.looseObject("featured in value. item.", {}))),
+            id: s.nullable(s.string("id value.")),
+            in_app_purchases: s.nullable(s.string("in app purchases value.")),
+            information: s.nullable(s.looseObject("information value.", {})),
+            ipad_screenshots: s.nullable(s.array("ipad screenshots value.", s.string("ipad screenshots value. item."))),
+            iphone_screenshots: s.nullable(s.array("iphone screenshots value.", s.string("iphone screenshots value. item."))),
+            logo: s.nullable(s.string("logo value.")),
+            more_by_this_developer: s.nullable(s.looseObject("more by this developer value.", {})),
+            price: s.nullable(s.string("price value.")),
+            privacy: s.nullable(s.looseObject("privacy value.", {})),
+            rating: s.nullable(s.number("rating value.")),
+            rating_count: s.nullable(s.string("rating count value.")),
+            ratings_and_reviews: s.nullable(s.looseObject("ratings and reviews value.", {})),
+            snippet: s.nullable(s.string("snippet value.")),
+            title: s.nullable(s.string("title value.")),
+            version_history: s.nullable(s.array("version history value.", s.looseObject("version history value. item.", {}))),
+            you_may_also_like: s.nullable(s.looseObject("you may also like value.", {})),
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "apple_app_store_reviews",
+        path: "/api/apple/app-store/reviews",
+        description: "Get reviews for an App Store app.",
+        input: s.object("Apple App Store Reviews parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            product_id: s.string("Positive decimal Apple app identifier, up to 20 digits.", {
+                pattern: "^[1-9][0-9]{0,19}$",
+            }),
+            sort: s.withEnum(s.unknown("mostrecent or mosthelpful. Apple's Mac storefront always returns newest first."), [
+                "mostrecent",
+                "mosthelpful",
+            ]),
+            page: s.integer("One-based page number, from 1 through 2,147,483,647. Exhausted pages return an empty review list.", { minimum: 1, maximum: 2147483647 }),
+        }, { required: ["product_id"] }),
+        asyncInput: s.object("Apple App Store Reviews asynchronous parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            product_id: s.string("Positive decimal Apple app identifier, up to 20 digits.", {
+                pattern: "^[1-9][0-9]{0,19}$",
+            }),
+            sort: s.withEnum(s.unknown("mostrecent or mosthelpful. Apple's Mac storefront always returns newest first."), [
+                "mostrecent",
+                "mosthelpful",
+            ]),
+            page: s.integer("One-based page number, from 1 through 2,147,483,647. Exhausted pages return an empty review list.", { minimum: 1, maximum: 2147483647 }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["product_id"] }),
+        output: s.looseObject("Apple App Store Reviews response.", {
+            reviews: s.nullable(s.array("reviews value.", s.looseObject("reviews value. item.", {}))),
+            search_information: s.nullable(s.looseObject("search information value.", {})),
+            raises: s.nullable(s.looseObject("raises value.", {})),
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "apple_app_store_search",
+        path: "/api/apple/app-store/search",
+        description: "Search the App Store for iPhone, iPad and Mac apps.",
+        input: s.object("Apple App Store Search parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            term: s.string("Search term with 1 to 2,048 UTF-8 bytes of printable text, and at most 4,096 bytes after URL encoding.", { minLength: 1, maxLength: 2048 }),
+            lang: s.string("Language-region code, such as en-us or fr-fr.", {
+                pattern: "^[a-zA-Z]{2,3}-[a-zA-Z]{2}$",
+            }),
+            num: s.integer("Maximum results after filtering, from 1 through 200.", {
+                minimum: 1,
+                maximum: 200,
+            }),
+            disallow_explicit: s.boolean("Exclude explicit results when true."),
+            property: s.nullable(s.literal("developer", {
+                description: "Use developer to match developer names, ignoring case.",
+            })),
+            category_id: s.nullable(s.integer("Filter results by a native genre identifier, from 1 through 2,147,483,647.", {
+                minimum: 1,
+                maximum: 2147483647,
+            })),
+            device: s.withEnum(s.unknown("mobile for iPhone apps, tablet for iPad apps, or desktop for Mac apps."), [
+                "mobile",
+                "tablet",
+                "desktop",
+            ]),
+        }, { required: ["term"] }),
+        asyncInput: s.object("Apple App Store Search asynchronous parameters.", {
+            country: s.string("Two-letter Apple storefront country. UK is accepted as an alias for GB.", {
+                pattern: "^[a-zA-Z]{2}$",
+            }),
+            term: s.string("Search term with 1 to 2,048 UTF-8 bytes of printable text, and at most 4,096 bytes after URL encoding.", { minLength: 1, maxLength: 2048 }),
+            lang: s.string("Language-region code, such as en-us or fr-fr.", {
+                pattern: "^[a-zA-Z]{2,3}-[a-zA-Z]{2}$",
+            }),
+            num: s.integer("Maximum results after filtering, from 1 through 200.", {
+                minimum: 1,
+                maximum: 200,
+            }),
+            disallow_explicit: s.boolean("Exclude explicit results when true."),
+            property: s.literal("developer", {
+                description: "Use developer to match developer names, ignoring case.",
+            }),
+            category_id: s.integer("Filter results by a native genre identifier, from 1 through 2,147,483,647.", {
+                minimum: 1,
+                maximum: 2147483647,
+            }),
+            device: s.withEnum(s.unknown("mobile for iPhone apps, tablet for iPad apps, or desktop for Mac apps."), [
+                "mobile",
+                "tablet",
+                "desktop",
+            ]),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["term"] }),
+        output: s.looseObject("Apple App Store Search response.", {
+            organic_results: s.nullable(s.array("organic results value.", s.looseObject("organic results value. item.", {}))),
+            search_information: s.nullable(s.looseObject("search information value.", {})),
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "apple_maps_places",
+        path: "/api/apple/maps/places",
+        description: "Search Apple Maps places.",
+        input: s.object("Apple Maps Places parameters.", {
+            muid: s.string("One or more Apple Maps unique place identifiers.\n\nSeparate multiple identifiers with commas. Accepted batch size: 1 through 50 unsigned 64-bit decimal IDs. Example: 4372355869446211302."),
+            locale: s.string("Controls Apple Maps language and regional formatting.\n\nExamples: en-US, fr-FR, ja-JP, and zh-TW."),
+        }, { required: ["muid"] }),
+        asyncInput: s.object("Apple Maps Places asynchronous parameters.", {
+            muid: s.string("One or more Apple Maps unique place identifiers.\n\nSeparate multiple identifiers with commas. Accepted batch size: 1 through 50 unsigned 64-bit decimal IDs. Example: 4372355869446211302."),
+            locale: s.string("Controls Apple Maps language and regional formatting.\n\nExamples: en-US, fr-FR, ja-JP, and zh-TW."),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["muid"] }),
+        output: s.looseObject("Apple Maps Places response.", {
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            place_results: s.nullable(s.array("place results value.", s.looseObject("place results value. item.", {}))),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "apple_maps_reviews",
+        path: "/api/apple/maps/reviews",
+        description: "Get Apple ratings and reviews for an Apple Maps place.",
+        input: s.object("Apple Maps Reviews parameters.", {
+            muid: s.string("Exactly one unsigned 64-bit decimal Apple Maps MUID."),
+            locale: s.string("Apple Maps language and regional formatting."),
+        }, { required: ["muid"] }),
+        asyncInput: s.object("Apple Maps Reviews asynchronous parameters.", {
+            muid: s.string("Exactly one unsigned 64-bit decimal Apple Maps MUID."),
+            locale: s.string("Apple Maps language and regional formatting."),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["muid"] }),
+        output: s.looseObject("Apple Maps Reviews response.", {
+            search_metadata: s.nullable(s.looseObject("search metadata value.", {})),
+            search_parameters: s.nullable(s.looseObject("search parameters value.", {})),
+            search_information: s.nullable(s.looseObject("search information value.", {})),
+            place_info: s.nullable(s.looseObject("place info value.", {})),
+            reviews: s.nullable(s.array("reviews value.", s.looseObject("reviews value. item.", {}))),
+            ratings: s.nullable(s.looseObject("ratings value.", {})),
+            rating_summary: s.nullable(s.looseObject("rating summary value.", {})),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

package/src/providers/litescrape/ashby-schemas.d.ts

@@ -0,0 +1,2 @@
+import type { DataTool } from "./shared.ts";
+export declare const ashbyTools: DataTool[];

package/src/providers/litescrape/ashby-schemas.js

@@ -0,0 +1,82 @@
+import { s } from "../../core/json-schema.js";
+export const ashbyTools = [
+    {
+        name: "ashby_search",
+        path: "/api/ashby/search",
+        description: "Search jobs on a company's Ashby job board.",
+        input: s.object("Jobs by Ashby Search parameters.", {
+            q: s.nullable(s.string("Case-insensitive phrase in title or description.", {
+                minLength: 1,
+                maxLength: 512,
+            })),
+            page: s.integer("One-based results page. Use next_page from the response to continue.", {
+                minimum: 1,
+            }),
+            board: s.string("Employer board name from jobs.ashbyhq.com/{board}, for example ashby.", {
+                pattern: "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$",
+            }),
+            location: s.nullable(s.string("Case-insensitive phrase in primary or secondary locations.", {
+                minLength: 1,
+                maxLength: 512,
+            })),
+            department: s.nullable(s.string("Case-insensitive department name.", { minLength: 1, maxLength: 512 })),
+            team: s.nullable(s.string("Exact team name, case-insensitive.", { minLength: 1, maxLength: 512 })),
+            workplace_type: s.nullable(s.withEnum(s.unknown("Employer's workplace type."), ["OnSite", "Remote", "Hybrid"])),
+            country: s.nullable(s.string("Country from a primary or secondary postal address, for example USA. Exact case-insensitive match.", { minLength: 1, maxLength: 512 })),
+            region: s.nullable(s.string("State or province from a primary or secondary postal address. Exact case-insensitive match.", {
+                minLength: 1,
+                maxLength: 512,
+            })),
+            city: s.nullable(s.string("City from a primary or secondary postal address. All supplied address filters must match the same address.", { minLength: 1, maxLength: 512 })),
+            remote: s.nullable(s.boolean("True selects remote jobs. False selects non-remote jobs.")),
+            employment_type: s.nullable(s.withEnum(s.unknown("Employment type."), ["FullTime", "PartTime", "Intern", "Contract", "Temporary"])),
+            limit: s.integer("Results per page.", { minimum: 1, maximum: 100 }),
+            include_compensation: s.boolean("Include published compensation tiers and salary ranges."),
+        }, { required: ["board"] }),
+        asyncInput: s.object("Jobs by Ashby Search asynchronous parameters.", {
+            q: s.string("Case-insensitive phrase in title or description.", {
+                minLength: 1,
+                maxLength: 512,
+            }),
+            page: s.integer("One-based results page. Use next_page from the response to continue.", {
+                minimum: 1,
+            }),
+            board: s.string("Employer board name from jobs.ashbyhq.com/{board}, for example ashby.", {
+                pattern: "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$",
+            }),
+            location: s.string("Case-insensitive phrase in primary or secondary locations.", {
+                minLength: 1,
+                maxLength: 512,
+            }),
+            department: s.string("Case-insensitive department name.", { minLength: 1, maxLength: 512 }),
+            team: s.string("Exact team name, case-insensitive.", { minLength: 1, maxLength: 512 }),
+            workplace_type: s.withEnum(s.unknown("Employer's workplace type."), ["OnSite", "Remote", "Hybrid"]),
+            country: s.string("Country from a primary or secondary postal address, for example USA. Exact case-insensitive match.", { minLength: 1, maxLength: 512 }),
+            region: s.string("State or province from a primary or secondary postal address. Exact case-insensitive match.", { minLength: 1, maxLength: 512 }),
+            city: s.string("City from a primary or secondary postal address. All supplied address filters must match the same address.", { minLength: 1, maxLength: 512 }),
+            remote: s.boolean("True selects remote jobs. False selects non-remote jobs."),
+            employment_type: s.withEnum(s.unknown("Employment type."), [
+                "FullTime",
+                "PartTime",
+                "Intern",
+                "Contract",
+                "Temporary",
+            ]),
+            limit: s.integer("Results per page.", { minimum: 1, maximum: 100 }),
+            include_compensation: s.boolean("Include published compensation tiers and salary ranges."),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["board"] }),
+        output: s.looseObject("Jobs by Ashby Search response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            jobs_results: s.array("jobs results value.", s.looseObject("jobs results value. item.", {})),
+            search_information: s.looseObject("search information value.", {}),
+            pagination: s.looseObject("pagination value.", {}),
+            litescrape_pagination: s.looseObject("litescrape pagination value.", {}),
+            available_filters: s.nullable(s.array("available filters value.", s.looseObject("available filters value. item.", {}))),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

package/src/providers/litescrape/baidu-schemas.d.ts

@@ -0,0 +1,2 @@
+import type { DataTool } from "./shared.ts";
+export declare const baiduTools: DataTool[];

package/src/providers/litescrape/baidu-schemas.js

@@ -0,0 +1,31 @@
+import { s } from "../../core/json-schema.js";
+export const baiduTools = [
+    {
+        name: "baidu_search",
+        path: "/api/baidu/search",
+        description: "Get Baidu search results as JSON.",
+        input: s.object("Baidu Search parameters.", {
+            q: s.string("Required search text, trimmed to 1 through 500 characters. Unicode queries are supported. Control characters are rejected.", { minLength: 1, maxLength: 500 }),
+            pn: s.integer("Zero-based result offset from 0 through 750, not a page number. Use pagination.next_pn or litescrape_pagination.next to continue.", { minimum: 0, maximum: 750 }),
+            rn: s.withEnum(s.unknown("Requested result count: 10, 20, or 50. Defaults to 10. Baidu can return fewer web results when a page includes other result modules."), [10, 20, 50]),
+        }, { required: ["q"] }),
+        asyncInput: s.object("Baidu Search asynchronous parameters.", {
+            q: s.string("Required search text, trimmed to 1 through 500 characters. Unicode queries are supported. Control characters are rejected.", { minLength: 1, maxLength: 500 }),
+            pn: s.integer("Zero-based result offset from 0 through 750, not a page number. Use pagination.next_pn or litescrape_pagination.next to continue.", { minimum: 0, maximum: 750 }),
+            rn: s.withEnum(s.unknown("Requested result count: 10, 20, or 50. Defaults to 10. Baidu can return fewer web results when a page includes other result modules."), [10, 20, 50]),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["q"] }),
+        output: s.looseObject("Baidu Search response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            organic_results: s.array("organic results value.", s.looseObject("organic results value. item.", {})),
+            search_information: s.looseObject("search information value.", {}),
+            related_searches: s.nullable(s.array("related searches value.", s.looseObject("related searches value. item.", {}))),
+            pagination: s.looseObject("pagination value.", {}),
+            litescrape_pagination: s.looseObject("litescrape pagination value.", {}),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

package/src/providers/litescrape/bestbuy-schemas.d.ts

@@ -0,0 +1,2 @@
+import type { DataTool } from "./shared.ts";
+export declare const bestbuyTools: DataTool[];

package/src/providers/litescrape/bestbuy-schemas.js

@@ -0,0 +1,56 @@
+import { s } from "../../core/json-schema.js";
+export const bestbuyTools = [
+    {
+        name: "bestbuy_product",
+        path: "/api/bestbuy/product",
+        description: "Get a Best Buy product's details, price and availability. This upstream API is Alpha.",
+        input: s.object("Best Buy Product parameters.", {
+            url: s.string("Public HTTPS product URL on this retailer's site.", {
+                minLength: 1,
+                maxLength: 4096,
+            }),
+            store_id: s.nullable(s.string("Retailer's store ID. Selects the store catalog, pricing or availability where the retailer exposes it.", { minLength: 1, maxLength: 8, pattern: "^[0-9]{1,8}$" })),
+        }, { required: ["url"] }),
+        asyncInput: s.object("Best Buy Product asynchronous parameters.", {
+            url: s.string("Public HTTPS product URL on this retailer's site.", {
+                minLength: 1,
+                maxLength: 4096,
+            }),
+            store_id: s.string("Retailer's store ID. Selects the store catalog, pricing or availability where the retailer exposes it.", { minLength: 1, maxLength: 8, pattern: "^[0-9]{1,8}$" }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["url"] }),
+        output: s.looseObject("Best Buy Product response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            product: s.looseObject("product value.", {}),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+    {
+        name: "bestbuy_search",
+        path: "/api/bestbuy/search",
+        description: "Search Best Buy products with prices and availability. This upstream API is Alpha.",
+        input: s.object("Best Buy Search parameters.", {
+            query: s.string("Product keywords to search for.", { minLength: 1, maxLength: 500 }),
+            page: s.integer("One-based result page.", { minimum: 1, maximum: 100 }),
+            store_id: s.nullable(s.string("Retailer's store ID. Selects the store catalog, pricing or availability where the retailer exposes it.", { minLength: 1, maxLength: 8, pattern: "^[0-9]{1,8}$" })),
+        }, { required: ["query"] }),
+        asyncInput: s.object("Best Buy Search asynchronous parameters.", {
+            query: s.string("Product keywords to search for.", { minLength: 1, maxLength: 500 }),
+            page: s.integer("One-based result page.", { minimum: 1, maximum: 100 }),
+            store_id: s.string("Retailer's store ID. Selects the store catalog, pricing or availability where the retailer exposes it.", { minLength: 1, maxLength: 8, pattern: "^[0-9]{1,8}$" }),
+            timeout: s.number("Execution budget in seconds for each attempt. Queue and retry backoff time do not consume it. Supply once, in the JSON body or query string.", { maximum: 90, exclusiveMinimum: 0 }),
+        }, { required: ["query"] }),
+        output: s.looseObject("Best Buy Search response.", {
+            search_metadata: s.looseObject("search metadata value.", {}),
+            search_parameters: s.looseObject("search parameters value.", {}),
+            products: s.array("products value.", s.looseObject("products value. item.", {})),
+            pagination: s.looseObject("pagination value.", {}),
+            submit_feedback_for_this_response_here: s.string("Optional URL for submitting feedback about this result.", {
+                format: "uri",
+            }),
+        }),
+    },
+];

package/src/providers/litescrape/bing-schemas.d.ts

@@ -0,0 +1,2 @@
+import type { DataTool } from "./shared.ts";
+export declare const bingTools: DataTool[];