@oomol-lab/open-connector 1.9.1 → 1.9.2

package/assets/open-connector/catalog/apps/search1api.json

@@ -0,0 +1,2382 @@
+{
+  "service": "search1api",
+  "displayName": "Search1API",
+  "homepageUrl": "https://s1.dev",
+  "categories": [
+    "AI",
+    "Data"
+  ],
+  "authTypes": [
+    "api_key",
+    "oauth2"
+  ],
+  "auth": [
+    {
+      "type": "oauth2",
+      "authorizationUrl": "https://clerk.s1.dev/oauth/authorize",
+      "tokenUrl": "https://clerk.s1.dev/oauth/token",
+      "scopes": [
+        "openid",
+        "offline_access"
+      ],
+      "tokenEndpointAuthMethod": "none",
+      "pkce": {
+        "method": "S256"
+      }
+    },
+    {
+      "type": "api_key",
+      "label": "API Key",
+      "placeholder": "Search1API key",
+      "description": "Sign in at https://app.s1.dev, open API Keys and create a key. Connecting checks your balance without consuming credits.",
+      "extraFields": []
+    }
+  ],
+  "actions": [
+    {
+      "id": "search1api.ask",
+      "service": "search1api",
+      "name": "ask",
+      "description": "Select search engines and rank relevant sources from a natural-language query. Returns sources, not a generated answer; partial engine failures are preserved.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 500,
+            "description": "What you are looking for, in natural language. Platform hints (\"on Reddit\", \"papers\") and time hints (\"this week\") steer engine and time-range selection."
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "additionalProperties": false,
+        "description": "Agentic search parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "query",
+          "intent",
+          "results",
+          "errors"
+        ],
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "Search query."
+          },
+          "intent": {
+            "type": "object",
+            "required": [
+              "search_query",
+              "sources",
+              "time_range"
+            ],
+            "description": "Task intent or interpreted search intent.",
+            "properties": {
+              "search_query": {
+                "type": "string",
+                "description": "Query sent to the selected engine."
+              },
+              "sources": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "description": "One item: Selected engines."
+                },
+                "description": "Selected engines."
+              },
+              "time_range": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "enum": [
+                  "day",
+                  "week",
+                  "month",
+                  "year",
+                  null
+                ],
+                "description": "Publication time window."
+              }
+            },
+            "additionalProperties": true
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "title",
+                "link",
+                "snippet",
+                "source",
+                "relevance"
+              ],
+              "properties": {
+                "title": {
+                  "type": "string",
+                  "description": "Result title."
+                },
+                "link": {
+                  "type": "string",
+                  "format": "uri",
+                  "description": "Result source URL."
+                },
+                "snippet": {
+                  "type": "string",
+                  "description": "Relevant source excerpt."
+                },
+                "published_date": {
+                  "type": "string",
+                  "description": "Source publication date or UTC timestamp; omitted when unknown."
+                },
+                "source": {
+                  "type": "string",
+                  "description": "Source engine."
+                },
+                "relevance": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Relevance score between 0 and 1."
+                }
+              },
+              "description": "One item: Returned results, including partial batch outcomes where applicable.",
+              "additionalProperties": true
+            },
+            "description": "Returned results, including partial batch outcomes where applicable."
+          },
+          "errors": {
+            "type": "array",
+            "description": "Partial engine failures; successful results remain available.",
+            "items": {
+              "type": "object",
+              "required": [
+                "source",
+                "message"
+              ],
+              "properties": {
+                "source": {
+                  "type": "string",
+                  "description": "Source engine."
+                },
+                "message": {
+                  "type": "string",
+                  "description": "Human-readable message."
+                }
+              },
+              "description": "One item: Partial engine failures; successful results remain available.",
+              "additionalProperties": true
+            }
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      }
+    },
+    {
+      "id": "search1api.crawl",
+      "service": "search1api",
+      "name": "crawl",
+      "description": "Read a public webpage as clean content, with optional fallback retrieval.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "minLength": 1,
+            "description": "Public source URL for Search1API to retrieve."
+          },
+          "enableFallback": {
+            "type": "boolean",
+            "description": "Enable fallback retrieval when the initial crawl fails; defaults to true."
+          }
+        },
+        "required": [
+          "url"
+        ],
+        "additionalProperties": false,
+        "description": "Page retrieval parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "crawlParameters",
+          "results"
+        ],
+        "properties": {
+          "crawlParameters": {
+            "type": "object",
+            "required": [
+              "url"
+            ],
+            "properties": {
+              "url": {
+                "type": "string",
+                "format": "uri",
+                "description": "Public source URL for Search1API to retrieve."
+              }
+            },
+            "description": "Effective page retrieval parameters.",
+            "additionalProperties": true
+          },
+          "results": {
+            "type": "object",
+            "required": [
+              "title",
+              "link",
+              "content"
+            ],
+            "properties": {
+              "title": {
+                "type": "string",
+                "description": "Result title."
+              },
+              "link": {
+                "type": "string",
+                "format": "uri",
+                "description": "Result source URL."
+              },
+              "content": {
+                "type": "string",
+                "description": "Retrieved page content."
+              },
+              "metadata": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Source-specific metadata; additional fields are preserved."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Returned results, including partial batch outcomes where applicable."
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      }
+    },
+    {
+      "id": "search1api.crawl_batch",
+      "service": "search1api",
+      "name": "crawl_batch",
+      "description": "Read multiple public webpages in one batch, preserving individual results and failures.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "requests": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "format": "uri",
+                  "minLength": 1,
+                  "description": "Public source URL for Search1API to retrieve."
+                },
+                "enableFallback": {
+                  "type": "boolean",
+                  "description": "Enable fallback retrieval when the initial crawl fails; defaults to true."
+                }
+              },
+              "required": [
+                "url"
+              ],
+              "additionalProperties": false,
+              "description": "One item: Requests processed as one upstream batch; individual failures are preserved."
+            },
+            "minItems": 1,
+            "description": "Requests processed as one upstream batch; individual failures are preserved."
+          }
+        },
+        "required": [
+          "requests"
+        ],
+        "additionalProperties": false,
+        "description": "Requests processed as one upstream batch; individual failures are preserved."
+      },
+      "outputSchema": {
+        "type": "object",
+        "description": "Batch page retrieval responses.",
+        "properties": {
+          "results": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "crawlParameters",
+                "results"
+              ],
+              "properties": {
+                "crawlParameters": {
+                  "type": "object",
+                  "required": [
+                    "url"
+                  ],
+                  "properties": {
+                    "url": {
+                      "type": "string",
+                      "format": "uri",
+                      "description": "Public source URL for Search1API to retrieve."
+                    }
+                  },
+                  "description": "Effective page retrieval parameters.",
+                  "additionalProperties": true
+                },
+                "results": {
+                  "type": "object",
+                  "required": [
+                    "title",
+                    "link",
+                    "content"
+                  ],
+                  "properties": {
+                    "title": {
+                      "type": "string",
+                      "description": "Result title."
+                    },
+                    "link": {
+                      "type": "string",
+                      "format": "uri",
+                      "description": "Result source URL."
+                    },
+                    "content": {
+                      "type": "string",
+                      "description": "Retrieved page content."
+                    },
+                    "metadata": {
+                      "type": "object",
+                      "additionalProperties": true,
+                      "description": "Source-specific metadata; additional fields are preserved."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "Returned results, including partial batch outcomes where applicable."
+                }
+              },
+              "description": "One item: Returned results, including partial batch outcomes where applicable.",
+              "additionalProperties": true
+            },
+            "description": "Returned results, including partial batch outcomes where applicable."
+          }
+        },
+        "required": [
+          "results"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "id": "search1api.deepcrawl",
+      "service": "search1api",
+      "name": "deepcrawl",
+      "description": "Start an asynchronous whole-site crawl. Use get_deepcrawl to wait for the archive download URL. This upstream API is in beta.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "description": "Public source URL for Search1API to retrieve."
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "sitemap",
+              "all"
+            ],
+            "description": "Use sitemap discovery or discover all links."
+          }
+        },
+        "required": [
+          "url"
+        ],
+        "additionalProperties": false,
+        "description": "Deepcrawl submission parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "taskId",
+          "status"
+        ],
+        "properties": {
+          "taskId": {
+            "type": "string",
+            "description": "Deepcrawl task identifier."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "queued"
+            ],
+            "description": "Current operation status."
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      },
+      "asyncLifecycle": {
+        "startActionId": "search1api.deepcrawl",
+        "statusActionId": "search1api.get_deepcrawl"
+      }
+    },
+    {
+      "id": "search1api.extract",
+      "service": "search1api",
+      "name": "extract",
+      "description": "Extract structured data from a webpage using a prompt and response schema. This upstream API is in beta.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "description": "Public source URL for Search1API to retrieve."
+          },
+          "prompt": {
+            "type": "string",
+            "description": "Instructions describing which fields to extract."
+          },
+          "response_format": {
+            "type": "object",
+            "additionalProperties": {
+              "description": "JSON schema or response format defining the extracted data."
+            },
+            "description": "JSON schema or response format defining the extracted data."
+          }
+        },
+        "required": [
+          "url"
+        ],
+        "additionalProperties": false,
+        "description": "Structured extraction parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "success",
+          "extractParameters",
+          "results"
+        ],
+        "properties": {
+          "success": {
+            "type": "boolean",
+            "enum": [
+              true
+            ],
+            "description": "Whether this operation succeeded."
+          },
+          "extractParameters": {
+            "type": "object",
+            "required": [
+              "url"
+            ],
+            "properties": {
+              "url": {
+                "type": "string",
+                "format": "uri",
+                "description": "Public source URL for Search1API to retrieve."
+              }
+            },
+            "description": "Effective extraction parameters.",
+            "additionalProperties": true
+          },
+          "results": {
+            "description": "Returned results, including partial batch outcomes where applicable."
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      }
+    },
+    {
+      "id": "search1api.feedback",
+      "service": "search1api",
+      "name": "feedback",
+      "description": "Submit product feedback. Do not include credentials, personal data or private content; do not automatically repeat the same report.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 4000,
+            "description": "Human-readable message."
+          },
+          "intent": {
+            "type": "string",
+            "maxLength": 2000,
+            "description": "Task intent or interpreted search intent."
+          },
+          "category": {
+            "type": "string",
+            "enum": [
+              "bug",
+              "feature_request",
+              "docs",
+              "other"
+            ],
+            "description": "Feedback category."
+          },
+          "request_id": {
+            "type": "string",
+            "maxLength": 256,
+            "description": "Original request identifier."
+          },
+          "agent": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "maxLength": 128,
+                "description": "Agent name."
+              },
+              "model": {
+                "type": "string",
+                "maxLength": 128,
+                "description": "Agent model."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Agent name and model; do not include credentials or private content."
+          }
+        },
+        "required": [
+          "message"
+        ],
+        "additionalProperties": false,
+        "description": "Product feedback parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "id",
+          "status"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^fb_[a-zA-Z0-9_-]+$",
+            "maxLength": 80,
+            "description": "Feedback identifier."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "new"
+            ],
+            "description": "Current operation status."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Returned results, including partial batch outcomes where applicable."
+      }
+    },
+    {
+      "id": "search1api.get_deepcrawl",
+      "service": "search1api",
+      "name": "get_deepcrawl",
+      "description": "Read the state and archive download URL of a deepcrawl task.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "taskId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Deepcrawl task identifier.",
+            "not": {
+              "enum": [
+                ".",
+                ".."
+              ]
+            }
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "taskId"
+        ],
+        "description": "Deepcrawl task lookup parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "taskId"
+        ],
+        "properties": {
+          "taskId": {
+            "type": "string",
+            "description": "Deepcrawl task identifier."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "queued",
+              "waiting",
+              "processing",
+              "completed",
+              "failed",
+              "not_found"
+            ],
+            "description": "Current operation status."
+          },
+          "success": {
+            "type": "boolean",
+            "description": "Whether this operation succeeded."
+          },
+          "message": {
+            "type": "string",
+            "description": "Human-readable message."
+          },
+          "error": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Upstream error or failure details."
+          },
+          "r2Key": {
+            "type": "string",
+            "description": "Upstream archive storage key."
+          },
+          "zipUrl": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uri",
+            "description": "Download URL for the completed crawl archive."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Returned results, including partial batch outcomes where applicable."
+      }
+    },
+    {
+      "id": "search1api.health",
+      "service": "search1api",
+      "name": "health",
+      "description": "Check public API health. This does not validate credentials.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "Health check parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "status"
+        ],
+        "properties": {
+          "status": {
+            "type": "string",
+            "description": "Current operation status."
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Server timestamp."
+          },
+          "version": {
+            "type": "string",
+            "description": "Server version."
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      }
+    },
+    {
+      "id": "search1api.news",
+      "service": "search1api",
+      "name": "news",
+      "description": "Search recent news with source, site, language, time, image and full-content options.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Search query."
+          },
+          "search_service": {
+            "type": "string",
+            "enum": [
+              "google",
+              "bing",
+              "duckduckgo",
+              "yahoo",
+              "hackernews",
+              "",
+              "reuters"
+            ],
+            "description": "Search engine or trending source."
+          },
+          "max_results": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 50,
+            "description": "Maximum number of results."
+          },
+          "crawl_results": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 50,
+            "description": "Number of result pages to read; each page may consume additional credits."
+          },
+          "image": {
+            "type": "boolean",
+            "description": "Include image results."
+          },
+          "include_sites": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One item: Restrict results to these sites."
+            },
+            "description": "Restrict results to these sites."
+          },
+          "exclude_sites": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One item: Exclude these sites."
+            },
+            "description": "Exclude these sites."
+          },
+          "language": {
+            "type": "string",
+            "description": "Preferred result language."
+          },
+          "time_range": {
+            "type": "string",
+            "enum": [
+              "day",
+              "week",
+              "month",
+              "year",
+              ""
+            ],
+            "description": "Publication time window."
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "additionalProperties": false,
+        "description": "News search parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "searchParameters",
+          "results"
+        ],
+        "properties": {
+          "searchParameters": {
+            "type": "object",
+            "properties": {
+              "query": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Search query."
+              },
+              "search_service": {
+                "type": "string",
+                "enum": [
+                  "google",
+                  "bing",
+                  "duckduckgo",
+                  "yahoo",
+                  "hackernews",
+                  "",
+                  "reuters"
+                ],
+                "description": "Search engine or trending source."
+              },
+              "max_results": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 50,
+                "description": "Maximum number of results."
+              },
+              "crawl_results": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 50,
+                "description": "Number of result pages to read; each page may consume additional credits."
+              },
+              "image": {
+                "type": "boolean",
+                "description": "Include image results."
+              },
+              "include_sites": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "description": "One item: Restrict results to these sites."
+                },
+                "description": "Restrict results to these sites."
+              },
+              "exclude_sites": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "description": "One item: Exclude these sites."
+                },
+                "description": "Exclude these sites."
+              },
+              "language": {
+                "type": "string",
+                "description": "Preferred result language."
+              },
+              "time_range": {
+                "type": "string",
+                "enum": [
+                  "day",
+                  "week",
+                  "month",
+                  "year",
+                  ""
+                ],
+                "description": "Publication time window."
+              }
+            },
+            "required": [
+              "query"
+            ],
+            "additionalProperties": true,
+            "description": "Effective search parameters."
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "title",
+                "link",
+                "snippet"
+              ],
+              "properties": {
+                "title": {
+                  "type": "string",
+                  "description": "Result title."
+                },
+                "link": {
+                  "type": "string",
+                  "format": "uri",
+                  "description": "Result source URL."
+                },
+                "snippet": {
+                  "type": "string",
+                  "description": "Relevant source excerpt."
+                },
+                "content": {
+                  "type": "string",
+                  "description": "Retrieved page content."
+                },
+                "published_date": {
+                  "type": "string",
+                  "description": "Source publication date or UTC timestamp; omitted when unknown."
+                },
+                "metadata": {
+                  "type": "object",
+                  "description": "Source-specific metadata; additional fields are preserved.",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "enum": [
+                        "repo",
+                        "issue",
+                        "pr",
+                        "discussion"
+                      ],
+                      "description": "GitHub result kind."
+                    },
+                    "stars": {
+                      "type": "integer",
+                      "description": "Repository star count."
+                    },
+                    "language": {
+                      "type": "string",
+                      "description": "Preferred result language."
+                    },
+                    "num_comments": {
+                      "type": "integer",
+                      "description": "Source comment count."
+                    },
+                    "story_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "description": "Original article URL for a Hacker News discussion."
+                    },
+                    "points": {
+                      "type": "integer",
+                      "description": "Hacker News vote count."
+                    }
+                  },
+                  "additionalProperties": true
+                }
+              },
+              "additionalProperties": true,
+              "description": "One item: Returned results, including partial batch outcomes where applicable."
+            },
+            "description": "Returned results, including partial batch outcomes where applicable."
+          },
+          "images": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uri",
+              "description": "One item: Image URLs."
+            },
+            "description": "Image URLs."
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      }
+    },
+    {
+      "id": "search1api.news_batch",
+      "service": "search1api",
+      "name": "news_batch",
+      "description": "Run multiple news searches in one batch, preserving each success, failure and credit cost.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "requests": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "query": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Search query."
+                },
+                "search_service": {
+                  "type": "string",
+                  "enum": [
+                    "google",
+                    "bing",
+                    "duckduckgo",
+                    "yahoo",
+                    "hackernews",
+                    "",
+                    "reuters"
+                  ],
+                  "description": "Search engine or trending source."
+                },
+                "max_results": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 50,
+                  "description": "Maximum number of results."
+                },
+                "crawl_results": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 50,
+                  "description": "Number of result pages to read; each page may consume additional credits."
+                },
+                "image": {
+                  "type": "boolean",
+                  "description": "Include image results."
+                },
+                "include_sites": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "description": "One item: Restrict results to these sites."
+                  },
+                  "description": "Restrict results to these sites."
+                },
+                "exclude_sites": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "description": "One item: Exclude these sites."
+                  },
+                  "description": "Exclude these sites."
+                },
+                "language": {
+                  "type": "string",
+                  "description": "Preferred result language."
+                },
+                "time_range": {
+                  "type": "string",
+                  "enum": [
+                    "day",
+                    "week",
+                    "month",
+                    "year",
+                    ""
+                  ],
+                  "description": "Publication time window."
+                }
+              },
+              "required": [
+                "query"
+              ],
+              "additionalProperties": false,
+              "description": "One item: Requests processed as one upstream batch; individual failures are preserved."
+            },
+            "minItems": 1,
+            "description": "Requests processed as one upstream batch; individual failures are preserved."
+          }
+        },
+        "required": [
+          "requests"
+        ],
+        "additionalProperties": false,
+        "description": "Requests processed as one upstream batch; individual failures are preserved."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "results",
+          "summary"
+        ],
+        "properties": {
+          "results": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "success",
+                "cost"
+              ],
+              "properties": {
+                "success": {
+                  "type": "boolean",
+                  "description": "Whether this operation succeeded."
+                },
+                "data": {
+                  "type": "object",
+                  "required": [
+                    "searchParameters",
+                    "results"
+                  ],
+                  "properties": {
+                    "searchParameters": {
+                      "type": "object",
+                      "properties": {
+                        "query": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Search query."
+                        },
+                        "search_service": {
+                          "type": "string",
+                          "enum": [
+                            "google",
+                            "bing",
+                            "duckduckgo",
+                            "yahoo",
+                            "hackernews",
+                            "",
+                            "reuters"
+                          ],
+                          "description": "Search engine or trending source."
+                        },
+                        "max_results": {
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 50,
+                          "description": "Maximum number of results."
+                        },
+                        "crawl_results": {
+                          "type": "integer",
+                          "minimum": 0,
+                          "maximum": 50,
+                          "description": "Number of result pages to read; each page may consume additional credits."
+                        },
+                        "image": {
+                          "type": "boolean",
+                          "description": "Include image results."
+                        },
+                        "include_sites": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "description": "One item: Restrict results to these sites."
+                          },
+                          "description": "Restrict results to these sites."
+                        },
+                        "exclude_sites": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "description": "One item: Exclude these sites."
+                          },
+                          "description": "Exclude these sites."
+                        },
+                        "language": {
+                          "type": "string",
+                          "description": "Preferred result language."
+                        },
+                        "time_range": {
+                          "type": "string",
+                          "enum": [
+                            "day",
+                            "week",
+                            "month",
+                            "year",
+                            ""
+                          ],
+                          "description": "Publication time window."
+                        }
+                      },
+                      "required": [
+                        "query"
+                      ],
+                      "additionalProperties": true,
+                      "description": "Effective search parameters."
+                    },
+                    "results": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "title",
+                          "link",
+                          "snippet"
+                        ],
+                        "properties": {
+                          "title": {
+                            "type": "string",
+                            "description": "Result title."
+                          },
+                          "link": {
+                            "type": "string",
+                            "format": "uri",
+                            "description": "Result source URL."
+                          },
+                          "snippet": {
+                            "type": "string",
+                            "description": "Relevant source excerpt."
+                          },
+                          "content": {
+                            "type": "string",
+                            "description": "Retrieved page content."
+                          },
+                          "published_date": {
+                            "type": "string",
+                            "description": "Source publication date or UTC timestamp; omitted when unknown."
+                          },
+                          "metadata": {
+                            "type": "object",
+                            "description": "Source-specific metadata; additional fields are preserved.",
+                            "properties": {
+                              "kind": {
+                                "type": "string",
+                                "enum": [
+                                  "repo",
+                                  "issue",
+                                  "pr",
+                                  "discussion"
+                                ],
+                                "description": "GitHub result kind."
+                              },
+                              "stars": {
+                                "type": "integer",
+                                "description": "Repository star count."
+                              },
+                              "language": {
+                                "type": "string",
+                                "description": "Preferred result language."
+                              },
+                              "num_comments": {
+                                "type": "integer",
+                                "description": "Source comment count."
+                              },
+                              "story_url": {
+                                "type": "string",
+                                "format": "uri",
+                                "description": "Original article URL for a Hacker News discussion."
+                              },
+                              "points": {
+                                "type": "integer",
+                                "description": "Hacker News vote count."
+                              }
+                            },
+                            "additionalProperties": true
+                          }
+                        },
+                        "additionalProperties": true,
+                        "description": "One item: Returned results, including partial batch outcomes where applicable."
+                      },
+                      "description": "Returned results, including partial batch outcomes where applicable."
+                    },
+                    "images": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "format": "uri",
+                        "description": "One item: Image URLs."
+                      },
+                      "description": "Image URLs."
+                    }
+                  },
+                  "description": "Successful item response.",
+                  "additionalProperties": true
+                },
+                "error": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string",
+                      "description": "Human-readable message."
+                    },
+                    "statusCode": {
+                      "type": "integer",
+                      "description": "Upstream HTTP status code."
+                    }
+                  },
+                  "description": "Upstream error or failure details.",
+                  "additionalProperties": true
+                },
+                "cost": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Credits charged for this item."
+                }
+              },
+              "description": "One item: Returned results, including partial batch outcomes where applicable.",
+              "additionalProperties": true
+            },
+            "description": "Returned results, including partial batch outcomes where applicable."
+          },
+          "summary": {
+            "type": "object",
+            "required": [
+              "total",
+              "successful",
+              "failed",
+              "totalCost"
+            ],
+            "properties": {
+              "total": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Total batch items."
+              },
+              "successful": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Number of successful items."
+              },
+              "failed": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Number of failed items."
+              },
+              "totalCost": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Total credits charged."
+              }
+            },
+            "description": "Batch totals, successful and failed counts, and credits.",
+            "additionalProperties": true
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      }
+    },
+    {
+      "id": "search1api.screenshot",
+      "service": "search1api",
+      "name": "screenshot",
+      "description": "Capture a public webpage or element as PNG, JPEG or WebP and return a temporary file URL.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "maxLength": 4096,
+            "description": "Public source URL for Search1API to retrieve."
+          },
+          "format": {
+            "type": "string",
+            "enum": [
+              "png",
+              "jpeg",
+              "webp"
+            ],
+            "description": "Screenshot image format."
+          },
+          "full_page": {
+            "type": "boolean",
+            "description": "Capture the full page; cannot be combined with selector."
+          },
+          "viewport": {
+            "type": "object",
+            "properties": {
+              "width": {
+                "type": "integer",
+                "minimum": 320,
+                "maximum": 2560,
+                "description": "Viewport width in CSS pixels."
+              },
+              "height": {
+                "type": "integer",
+                "minimum": 200,
+                "maximum": 1440,
+                "description": "Viewport height in CSS pixels."
+              },
+              "device_scale_factor": {
+                "type": "number",
+                "minimum": 1,
+                "maximum": 2,
+                "description": "Device pixel ratio."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Browser viewport settings."
+          },
+          "wait_until": {
+            "type": "string",
+            "enum": [
+              "domcontentloaded",
+              "load",
+              "networkidle"
+            ],
+            "description": "Browser lifecycle event to wait for."
+          },
+          "wait_for_selector": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 500,
+            "description": "Wait until this CSS selector is visible."
+          },
+          "selector": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 500,
+            "description": "Capture the element matching this CSS selector."
+          },
+          "delay_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 5000,
+            "description": "Additional delay before capture, in milliseconds."
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "maximum": 30000,
+            "description": "Upstream screenshot deadline, in milliseconds."
+          },
+          "quality": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "JPEG or WebP quality."
+          },
+          "omit_background": {
+            "type": "boolean",
+            "description": "Omit the page background where supported."
+          },
+          "color_scheme": {
+            "type": "string",
+            "enum": [
+              "light",
+              "dark"
+            ],
+            "description": "Preferred page color scheme."
+          },
+          "animations": {
+            "type": "string",
+            "enum": [
+              "disabled",
+              "allow"
+            ],
+            "description": "Animation handling during capture."
+          }
+        },
+        "required": [
+          "url"
+        ],
+        "additionalProperties": false,
+        "description": "Screenshot capture parameters.",
+        "not": {
+          "additionalProperties": true,
+          "required": [
+            "full_page",
+            "selector"
+          ],
+          "properties": {
+            "full_page": {
+              "const": true
+            }
+          }
+        }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "description": "Temporary download URL for the screenshot."
+          },
+          "mimeType": {
+            "type": "string",
+            "description": "Screenshot MIME type."
+          },
+          "requestId": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "Upstream request identifier, when available."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Upstream request identifier, when available."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "url",
+          "mimeType",
+          "requestId"
+        ],
+        "description": "Captured screenshot file."
+      }
+    },
+    {
+      "id": "search1api.search",
+      "service": "search1api",
+      "name": "search",
+      "description": "Search the web with engine, site, language, time, pagination, image and full-content options.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Search query."
+          },
+          "search_service": {
+            "type": "string",
+            "enum": [
+              "google",
+              "bing",
+              "bingcn",
+              "duckduckgo",
+              "yahoo",
+              "yandex",
+              "youtube",
+              "x",
+              "reddit",
+              "github",
+              "arxiv",
+              "wechat",
+              "bilibili",
+              "imdb",
+              "wikipedia",
+              "grokipedia",
+              "",
+              "baidu",
+              "360",
+              "quark"
+            ],
+            "description": "Search engine or trending source."
+          },
+          "max_results": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 50,
+            "description": "Maximum number of results."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "Native search result page, starting at 1."
+          },
+          "crawl_results": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 50,
+            "description": "Number of result pages to read; each page may consume additional credits."
+          },
+          "image": {
+            "type": "boolean",
+            "description": "Include image results."
+          },
+          "include_sites": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One item: Restrict results to these sites."
+            },
+            "description": "Restrict results to these sites."
+          },
+          "exclude_sites": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One item: Exclude these sites."
+            },
+            "description": "Exclude these sites."
+          },
+          "language": {
+            "type": "string",
+            "description": "Preferred result language."
+          },
+          "time_range": {
+            "type": "string",
+            "enum": [
+              "day",
+              "week",
+              "month",
+              "year",
+              ""
+            ],
+            "description": "Publication time window."
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "additionalProperties": false,
+        "description": "Web search parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "searchParameters",
+          "results"
+        ],
+        "properties": {
+          "searchParameters": {
+            "type": "object",
+            "properties": {
+              "query": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Search query."
+              },
+              "search_service": {
+                "type": "string",
+                "enum": [
+                  "google",
+                  "bing",
+                  "bingcn",
+                  "duckduckgo",
+                  "yahoo",
+                  "yandex",
+                  "youtube",
+                  "x",
+                  "reddit",
+                  "github",
+                  "arxiv",
+                  "wechat",
+                  "bilibili",
+                  "imdb",
+                  "wikipedia",
+                  "grokipedia",
+                  "",
+                  "baidu",
+                  "360",
+                  "quark"
+                ],
+                "description": "Search engine or trending source."
+              },
+              "max_results": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 50,
+                "description": "Maximum number of results."
+              },
+              "page": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 100,
+                "description": "Native search result page, starting at 1."
+              },
+              "crawl_results": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 50,
+                "description": "Number of result pages to read; each page may consume additional credits."
+              },
+              "image": {
+                "type": "boolean",
+                "description": "Include image results."
+              },
+              "include_sites": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "description": "One item: Restrict results to these sites."
+                },
+                "description": "Restrict results to these sites."
+              },
+              "exclude_sites": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "description": "One item: Exclude these sites."
+                },
+                "description": "Exclude these sites."
+              },
+              "language": {
+                "type": "string",
+                "description": "Preferred result language."
+              },
+              "time_range": {
+                "type": "string",
+                "enum": [
+                  "day",
+                  "week",
+                  "month",
+                  "year",
+                  ""
+                ],
+                "description": "Publication time window."
+              }
+            },
+            "required": [
+              "query"
+            ],
+            "additionalProperties": true,
+            "description": "Effective search parameters."
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "title",
+                "link",
+                "snippet"
+              ],
+              "properties": {
+                "title": {
+                  "type": "string",
+                  "description": "Result title."
+                },
+                "link": {
+                  "type": "string",
+                  "format": "uri",
+                  "description": "Result source URL."
+                },
+                "snippet": {
+                  "type": "string",
+                  "description": "Relevant source excerpt."
+                },
+                "content": {
+                  "type": "string",
+                  "description": "Retrieved page content."
+                },
+                "published_date": {
+                  "type": "string",
+                  "description": "Source publication date or UTC timestamp; omitted when unknown."
+                },
+                "metadata": {
+                  "type": "object",
+                  "description": "Source-specific metadata; additional fields are preserved.",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "enum": [
+                        "repo",
+                        "issue",
+                        "pr",
+                        "discussion"
+                      ],
+                      "description": "GitHub result kind."
+                    },
+                    "stars": {
+                      "type": "integer",
+                      "description": "Repository star count."
+                    },
+                    "language": {
+                      "type": "string",
+                      "description": "Preferred result language."
+                    },
+                    "num_comments": {
+                      "type": "integer",
+                      "description": "Source comment count."
+                    },
+                    "story_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "description": "Original article URL for a Hacker News discussion."
+                    },
+                    "points": {
+                      "type": "integer",
+                      "description": "Hacker News vote count."
+                    }
+                  },
+                  "additionalProperties": true
+                }
+              },
+              "additionalProperties": true,
+              "description": "One item: Returned results, including partial batch outcomes where applicable."
+            },
+            "description": "Returned results, including partial batch outcomes where applicable."
+          },
+          "images": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uri",
+              "description": "One item: Image URLs."
+            },
+            "description": "Image URLs."
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      }
+    },
+    {
+      "id": "search1api.search_batch",
+      "service": "search1api",
+      "name": "search_batch",
+      "description": "Run multiple web searches in one batch, preserving each success, failure and credit cost.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "requests": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "query": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Search query."
+                },
+                "search_service": {
+                  "type": "string",
+                  "enum": [
+                    "google",
+                    "bing",
+                    "bingcn",
+                    "duckduckgo",
+                    "yahoo",
+                    "yandex",
+                    "youtube",
+                    "x",
+                    "reddit",
+                    "github",
+                    "arxiv",
+                    "wechat",
+                    "bilibili",
+                    "imdb",
+                    "wikipedia",
+                    "grokipedia",
+                    "",
+                    "baidu",
+                    "360",
+                    "quark"
+                  ],
+                  "description": "Search engine or trending source."
+                },
+                "max_results": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 50,
+                  "description": "Maximum number of results."
+                },
+                "page": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 100,
+                  "description": "Native search result page, starting at 1."
+                },
+                "crawl_results": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 50,
+                  "description": "Number of result pages to read; each page may consume additional credits."
+                },
+                "image": {
+                  "type": "boolean",
+                  "description": "Include image results."
+                },
+                "include_sites": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "description": "One item: Restrict results to these sites."
+                  },
+                  "description": "Restrict results to these sites."
+                },
+                "exclude_sites": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "description": "One item: Exclude these sites."
+                  },
+                  "description": "Exclude these sites."
+                },
+                "language": {
+                  "type": "string",
+                  "description": "Preferred result language."
+                },
+                "time_range": {
+                  "type": "string",
+                  "enum": [
+                    "day",
+                    "week",
+                    "month",
+                    "year",
+                    ""
+                  ],
+                  "description": "Publication time window."
+                }
+              },
+              "required": [
+                "query"
+              ],
+              "additionalProperties": false,
+              "description": "One item: Requests processed as one upstream batch; individual failures are preserved."
+            },
+            "minItems": 1,
+            "description": "Requests processed as one upstream batch; individual failures are preserved."
+          }
+        },
+        "required": [
+          "requests"
+        ],
+        "additionalProperties": false,
+        "description": "Requests processed as one upstream batch; individual failures are preserved."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "results",
+          "summary"
+        ],
+        "properties": {
+          "results": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "success",
+                "cost"
+              ],
+              "properties": {
+                "success": {
+                  "type": "boolean",
+                  "description": "Whether this operation succeeded."
+                },
+                "data": {
+                  "type": "object",
+                  "required": [
+                    "searchParameters",
+                    "results"
+                  ],
+                  "properties": {
+                    "searchParameters": {
+                      "type": "object",
+                      "properties": {
+                        "query": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Search query."
+                        },
+                        "search_service": {
+                          "type": "string",
+                          "enum": [
+                            "google",
+                            "bing",
+                            "bingcn",
+                            "duckduckgo",
+                            "yahoo",
+                            "yandex",
+                            "youtube",
+                            "x",
+                            "reddit",
+                            "github",
+                            "arxiv",
+                            "wechat",
+                            "bilibili",
+                            "imdb",
+                            "wikipedia",
+                            "grokipedia",
+                            "",
+                            "baidu",
+                            "360",
+                            "quark"
+                          ],
+                          "description": "Search engine or trending source."
+                        },
+                        "max_results": {
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 50,
+                          "description": "Maximum number of results."
+                        },
+                        "page": {
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 100,
+                          "description": "Native search result page, starting at 1."
+                        },
+                        "crawl_results": {
+                          "type": "integer",
+                          "minimum": 0,
+                          "maximum": 50,
+                          "description": "Number of result pages to read; each page may consume additional credits."
+                        },
+                        "image": {
+                          "type": "boolean",
+                          "description": "Include image results."
+                        },
+                        "include_sites": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "description": "One item: Restrict results to these sites."
+                          },
+                          "description": "Restrict results to these sites."
+                        },
+                        "exclude_sites": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "description": "One item: Exclude these sites."
+                          },
+                          "description": "Exclude these sites."
+                        },
+                        "language": {
+                          "type": "string",
+                          "description": "Preferred result language."
+                        },
+                        "time_range": {
+                          "type": "string",
+                          "enum": [
+                            "day",
+                            "week",
+                            "month",
+                            "year",
+                            ""
+                          ],
+                          "description": "Publication time window."
+                        }
+                      },
+                      "required": [
+                        "query"
+                      ],
+                      "additionalProperties": true,
+                      "description": "Effective search parameters."
+                    },
+                    "results": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "title",
+                          "link",
+                          "snippet"
+                        ],
+                        "properties": {
+                          "title": {
+                            "type": "string",
+                            "description": "Result title."
+                          },
+                          "link": {
+                            "type": "string",
+                            "format": "uri",
+                            "description": "Result source URL."
+                          },
+                          "snippet": {
+                            "type": "string",
+                            "description": "Relevant source excerpt."
+                          },
+                          "content": {
+                            "type": "string",
+                            "description": "Retrieved page content."
+                          },
+                          "published_date": {
+                            "type": "string",
+                            "description": "Source publication date or UTC timestamp; omitted when unknown."
+                          },
+                          "metadata": {
+                            "type": "object",
+                            "description": "Source-specific metadata; additional fields are preserved.",
+                            "properties": {
+                              "kind": {
+                                "type": "string",
+                                "enum": [
+                                  "repo",
+                                  "issue",
+                                  "pr",
+                                  "discussion"
+                                ],
+                                "description": "GitHub result kind."
+                              },
+                              "stars": {
+                                "type": "integer",
+                                "description": "Repository star count."
+                              },
+                              "language": {
+                                "type": "string",
+                                "description": "Preferred result language."
+                              },
+                              "num_comments": {
+                                "type": "integer",
+                                "description": "Source comment count."
+                              },
+                              "story_url": {
+                                "type": "string",
+                                "format": "uri",
+                                "description": "Original article URL for a Hacker News discussion."
+                              },
+                              "points": {
+                                "type": "integer",
+                                "description": "Hacker News vote count."
+                              }
+                            },
+                            "additionalProperties": true
+                          }
+                        },
+                        "additionalProperties": true,
+                        "description": "One item: Returned results, including partial batch outcomes where applicable."
+                      },
+                      "description": "Returned results, including partial batch outcomes where applicable."
+                    },
+                    "images": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "format": "uri",
+                        "description": "One item: Image URLs."
+                      },
+                      "description": "Image URLs."
+                    }
+                  },
+                  "description": "Successful item response.",
+                  "additionalProperties": true
+                },
+                "error": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string",
+                      "description": "Human-readable message."
+                    },
+                    "statusCode": {
+                      "type": "integer",
+                      "description": "Upstream HTTP status code."
+                    }
+                  },
+                  "description": "Upstream error or failure details.",
+                  "additionalProperties": true
+                },
+                "cost": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Credits charged for this item."
+                }
+              },
+              "description": "One item: Returned results, including partial batch outcomes where applicable.",
+              "additionalProperties": true
+            },
+            "description": "Returned results, including partial batch outcomes where applicable."
+          },
+          "summary": {
+            "type": "object",
+            "required": [
+              "total",
+              "successful",
+              "failed",
+              "totalCost"
+            ],
+            "properties": {
+              "total": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Total batch items."
+              },
+              "successful": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Number of successful items."
+              },
+              "failed": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Number of failed items."
+              },
+              "totalCost": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Total credits charged."
+              }
+            },
+            "description": "Batch totals, successful and failed counts, and credits.",
+            "additionalProperties": true
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      }
+    },
+    {
+      "id": "search1api.sitemap",
+      "service": "search1api",
+      "name": "sitemap",
+      "description": "Discover page URLs from a site's sitemap or all available links.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "description": "Public source URL for Search1API to retrieve."
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "sitemap",
+              "all"
+            ],
+            "description": "Use sitemap discovery or discover all links."
+          }
+        },
+        "required": [
+          "url"
+        ],
+        "additionalProperties": false,
+        "description": "Link discovery parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "links"
+        ],
+        "properties": {
+          "links": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uri",
+              "description": "One item: Discovered page URLs."
+            },
+            "description": "Discovered page URLs."
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      }
+    },
+    {
+      "id": "search1api.trending",
+      "service": "search1api",
+      "name": "trending",
+      "description": "Retrieve trending topics from the requested source.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "search_service": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Search engine or trending source."
+          },
+          "max_results": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Maximum number of results."
+          }
+        },
+        "required": [
+          "search_service"
+        ],
+        "additionalProperties": false,
+        "description": "Trending topic parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "trendingParameters",
+          "results"
+        ],
+        "properties": {
+          "trendingParameters": {
+            "type": "object",
+            "properties": {
+              "search_service": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Search engine or trending source."
+              },
+              "max_results": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Maximum number of results."
+              }
+            },
+            "required": [
+              "search_service"
+            ],
+            "additionalProperties": true,
+            "description": "Effective trending parameters."
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "title",
+                "url"
+              ],
+              "properties": {
+                "title": {
+                  "type": "string",
+                  "description": "Result title."
+                },
+                "url": {
+                  "type": "string",
+                  "format": "uri",
+                  "description": "Public source URL for Search1API to retrieve."
+                },
+                "description": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "Result description."
+                }
+              },
+              "description": "One item: Returned results, including partial batch outcomes where applicable.",
+              "additionalProperties": true
+            },
+            "description": "Returned results, including partial batch outcomes where applicable."
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      }
+    },
+    {
+      "id": "search1api.usage",
+      "service": "search1api",
+      "name": "usage",
+      "description": "Read the authenticated account's remaining credits without consuming credits.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "period": {
+            "type": "string",
+            "enum": [
+              "day",
+              "week",
+              "month",
+              "year"
+            ],
+            "description": "Usage reporting period."
+          }
+        },
+        "additionalProperties": false,
+        "required": [],
+        "description": "Account usage parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "required": [
+          "usage",
+          "credential_type"
+        ],
+        "properties": {
+          "usage": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Remaining account credits."
+          },
+          "user_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Account user identifier, when available."
+          },
+          "credential_type": {
+            "type": "string",
+            "enum": [
+              "api_key",
+              "oauth"
+            ],
+            "description": "Credential mode recognized by Search1API."
+          },
+          "client_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "OAuth client identifier, when available."
+          }
+        },
+        "description": "Returned results, including partial batch outcomes where applicable.",
+        "additionalProperties": true
+      }
+    }
+  ]
+}