{
  "service": "you",
  "displayName": "You.com",
  "categories": [
    "AI",
    "Data"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "YOU_API_KEY",
      "description": "You.com API key sent in the X-API-Key header. Create or manage keys on the You.com Platform API Keys page: https://you.com/platform/api-keys",
      "extraFields": []
    }
  ],
  "homepageUrl": "https://you.com/",
  "actions": [
    {
      "id": "you.fetch_contents",
      "service": "you",
      "name": "fetch_contents",
      "description": "Fetch HTML, Markdown, or metadata for one or more webpages with You.com.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "urls": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "One webpage URL."
            },
            "description": "Webpage URLs to fetch contents from.",
            "minItems": 1
          },
          "formats": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "html",
                "markdown",
                "metadata"
              ],
              "description": "One content format."
            },
            "description": "Content formats to return for each webpage.",
            "minItems": 1
          },
          "crawlTimeout": {
            "type": "integer",
            "minimum": 1,
            "maximum": 60,
            "description": "The maximum time in seconds to wait for page content."
          }
        },
        "additionalProperties": false,
        "required": [
          "urls"
        ],
        "description": "The input payload for fetching webpage contents."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "pages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "One webpage content result returned by You.com."
            },
            "description": "Fetched webpage contents."
          },
          "raw": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A JSON object passed through to or from You.com."
            },
            "description": "The raw content response array returned by You.com."
          }
        },
        "additionalProperties": false,
        "description": "The normalized webpage contents returned by You.com."
      }
    },
    {
      "id": "you.finance_research",
      "service": "you",
      "name": "finance_research",
      "description": "Generate a cited finance-grade answer with the You.com Finance Research API.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "input": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40000,
            "description": "The financial research question requiring in-depth investigation."
          },
          "researchEffort": {
            "type": "string",
            "enum": [
              "deep",
              "exhaustive"
            ],
            "description": "How much effort the Finance Research API spends on the question."
          }
        },
        "additionalProperties": false,
        "required": [
          "input"
        ],
        "description": "The input payload for You.com finance research."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "output": {
            "type": "object",
            "properties": {
              "content": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The answer content as Markdown text."
                  },
                  {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": true,
                    "description": "A JSON object passed through to or from You.com."
                  }
                ],
                "description": "The answer content as Markdown text or a structured JSON object."
              },
              "contentType": {
                "type": "string",
                "description": "The format of the content field."
              },
              "sources": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "description": "The URL of the source webpage."
                    },
                    "title": {
                      "type": "string",
                      "description": "The title of the source webpage."
                    },
                    "snippets": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "One source snippet."
                      },
                      "description": "Relevant excerpts from the source page."
                    },
                    "raw": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": true,
                      "description": "A JSON object passed through to or from You.com."
                    }
                  },
                  "additionalProperties": false,
                  "required": [
                    "url",
                    "raw"
                  ],
                  "description": "One source used to generate a research answer."
                },
                "description": "Sources used to generate the answer."
              },
              "raw": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A JSON object passed through to or from You.com."
              }
            },
            "additionalProperties": false,
            "description": "The research answer and its supporting sources."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "A JSON object passed through to or from You.com."
          }
        },
        "additionalProperties": false,
        "description": "The normalized finance research response returned by You.com."
      }
    },
    {
      "id": "you.get_account_balance",
      "service": "you",
      "name": "get_account_balance",
      "description": "Get the remaining You.com credit balance for the API key account.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "The input payload for getting the account balance."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "The billing entity type returned by You.com."
          },
          "id": {
            "type": "string",
            "description": "The stable hashed identifier for the billing entity."
          },
          "balanceCents": {
            "type": "number",
            "description": "The remaining credit balance in cents."
          },
          "balanceUsd": {
            "type": "number",
            "description": "The remaining credit balance converted to US dollars."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "A JSON object passed through to or from You.com."
          }
        },
        "additionalProperties": false,
        "description": "The normalized You.com account balance response."
      }
    },
    {
      "id": "you.research",
      "service": "you",
      "name": "research",
      "description": "Generate a cited research answer with the You.com Research API.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "input": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40000,
            "description": "The research question requiring in-depth investigation."
          },
          "researchEffort": {
            "type": "string",
            "enum": [
              "lite",
              "standard",
              "deep",
              "exhaustive"
            ],
            "description": "How much effort the Research API spends on the question."
          },
          "sourceControl": {
            "type": "object",
            "properties": {
              "includeDomains": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "description": "One value."
                },
                "description": "Domains to restrict results to. Cannot be combined with excludeDomains.",
                "minItems": 1
              },
              "excludeDomains": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "description": "One value."
                },
                "description": "Domains to exclude from results. Cannot be combined with includeDomains.",
                "minItems": 1
              },
              "boostDomains": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "description": "One value."
                },
                "description": "Domains to boost in ranking without filtering out other domains.",
                "minItems": 1
              },
              "freshness": {
                "type": "string",
                "minLength": 1,
                "description": "The freshness filter, such as day, week, month, year, or YYYY-MM-DDtoYYYY-MM-DD."
              },
              "country": {
                "type": "string",
                "minLength": 2,
                "description": "The country code that determines the geographical focus of the web results."
              }
            },
            "additionalProperties": false,
            "description": "Controls which web sources the research agent searches and visits."
          },
          "outputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "A JSON object passed through to or from You.com."
          }
        },
        "additionalProperties": false,
        "required": [
          "input"
        ],
        "description": "The input payload for You.com research."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "output": {
            "type": "object",
            "properties": {
              "content": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The answer content as Markdown text."
                  },
                  {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": true,
                    "description": "A JSON object passed through to or from You.com."
                  }
                ],
                "description": "The answer content as Markdown text or a structured JSON object."
              },
              "contentType": {
                "type": "string",
                "description": "The format of the content field."
              },
              "sources": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "description": "The URL of the source webpage."
                    },
                    "title": {
                      "type": "string",
                      "description": "The title of the source webpage."
                    },
                    "snippets": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "One source snippet."
                      },
                      "description": "Relevant excerpts from the source page."
                    },
                    "raw": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": true,
                      "description": "A JSON object passed through to or from You.com."
                    }
                  },
                  "additionalProperties": false,
                  "required": [
                    "url",
                    "raw"
                  ],
                  "description": "One source used to generate a research answer."
                },
                "description": "Sources used to generate the answer."
              },
              "raw": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A JSON object passed through to or from You.com."
              }
            },
            "additionalProperties": false,
            "description": "The research answer and its supporting sources."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "A JSON object passed through to or from You.com."
          }
        },
        "additionalProperties": false,
        "description": "The normalized research response returned by You.com."
      }
    },
    {
      "id": "you.search",
      "service": "you",
      "name": "search",
      "description": "Search web and news sources with the You.com Search API.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1,
            "description": "The search query used to retrieve relevant results."
          },
          "count": {
            "type": "integer",
            "minimum": 1,
            "description": "The maximum number of search results to return per section."
          },
          "freshness": {
            "type": "string",
            "minLength": 1,
            "description": "The freshness filter."
          },
          "offset": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9,
            "description": "The pagination offset calculated in multiples of count."
          },
          "country": {
            "type": "string",
            "minLength": 2,
            "description": "The country code that determines the geographical focus of results."
          },
          "language": {
            "type": "string",
            "minLength": 2,
            "description": "The language of the web results in BCP 47 format."
          },
          "safesearch": {
            "type": "string",
            "enum": [
              "off",
              "moderate",
              "strict"
            ],
            "description": "The safesearch content moderation setting."
          },
          "livecrawl": {
            "type": "string",
            "enum": [
              "web",
              "news",
              "all"
            ],
            "description": "The result sections to live-crawl for full page content."
          },
          "livecrawlFormats": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "html",
                "markdown"
              ],
              "description": "One livecrawl format."
            },
            "description": "The formats to return when livecrawl is enabled.",
            "minItems": 1
          },
          "includeDomains": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "One value."
            },
            "description": "Domains to restrict search results to.",
            "minItems": 1
          },
          "excludeDomains": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "One value."
            },
            "description": "Domains to exclude from search results.",
            "minItems": 1
          },
          "boostDomains": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "One value."
            },
            "description": "Domains to boost in search ranking.",
            "minItems": 1
          },
          "crawlTimeout": {
            "type": "integer",
            "minimum": 1,
            "maximum": 60,
            "description": "The maximum time in seconds to wait for page content."
          }
        },
        "additionalProperties": false,
        "required": [
          "query"
        ],
        "description": "The input payload for searching You.com."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "web": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "description": "The URL of the search result."
                },
                "title": {
                  "type": "string",
                  "description": "The title or name of the search result."
                },
                "description": {
                  "type": "string",
                  "description": "A brief description of the search result."
                },
                "snippets": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "description": "One result snippet."
                  },
                  "description": "Text snippets from the search result."
                },
                "thumbnailUrl": {
                  "type": "string",
                  "description": "The URL of the result thumbnail."
                },
                "pageAge": {
                  "type": "string",
                  "description": "The publication or crawl timestamp of the result."
                },
                "contents": {
                  "type": "object",
                  "properties": {
                    "html": {
                      "type": "string",
                      "description": "The HTML content of the page."
                    },
                    "markdown": {
                      "type": "string",
                      "description": "The Markdown content of the page."
                    }
                  },
                  "additionalProperties": false,
                  "description": "The live-crawled page contents returned for a search result."
                },
                "authors": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "description": "One author name."
                  },
                  "description": "The authors of the search result."
                },
                "faviconUrl": {
                  "type": "string",
                  "description": "The URL of the result domain favicon."
                },
                "raw": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A JSON object passed through to or from You.com."
                }
              },
              "additionalProperties": false,
              "required": [
                "raw"
              ],
              "description": "One web search result returned by You.com."
            },
            "description": "Web results returned by You.com."
          },
          "news": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "description": "The URL of the news result."
                },
                "title": {
                  "type": "string",
                  "description": "The title of the news result."
                },
                "description": {
                  "type": "string",
                  "description": "A brief description of the news result."
                },
                "pageAge": {
                  "type": "string",
                  "description": "The publication timestamp of the news result."
                },
                "thumbnailUrl": {
                  "type": "string",
                  "description": "The URL of the news thumbnail."
                },
                "contents": {
                  "type": "object",
                  "properties": {
                    "html": {
                      "type": "string",
                      "description": "The HTML content of the page."
                    },
                    "markdown": {
                      "type": "string",
                      "description": "The Markdown content of the page."
                    }
                  },
                  "additionalProperties": false,
                  "description": "The live-crawled page contents returned for a search result."
                },
                "raw": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A JSON object passed through to or from You.com."
                }
              },
              "additionalProperties": false,
              "required": [
                "raw"
              ],
              "description": "One news search result returned by You.com."
            },
            "description": "News results returned by You.com."
          },
          "metadata": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "Metadata returned with a You.com search response."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "A JSON object passed through to or from You.com."
          }
        },
        "additionalProperties": false,
        "description": "The normalized You.com search response."
      }
    }
  ]
}