serpapi

serpapi

serpapi.

SerpApi search — reach ANY SerpApi engine through the `engine=` axis.

ajouter à otoauth : —prefix : serpapi_*

setup & usage

⚠ obtenir une clé serpapi

crée une clé api (private api key) dans ton dashboard serpapi.

  • colle-la dans tes connecteurs oto sur /account
  • les membres peuvent aussi utiliser la clé plateforme (quota quotidien)
  • ▸ recherche multi-moteurs

    atteint des moteurs que serper n'a pas : verticaux google (trends, finance, vols, hôtels, events, jobs), bing, youtube et marketplaces.

  • serpapi_search(engine=…) — n'importe quel moteur serpapi : bing, youtube, amazon, walmart, ebay, google_events, et le générique (google_play, duckduckgo, yelp…)
  • serpapi_jobs(op="search"|"details") — sourcing d'offres via google jobs (le job_id du détail sort de la recherche)
  • serpapi_google_trends — intérêt dans le temps / par région pour un terme
  • serpapi_google_finance / serpapi_google_flights / serpapi_google_hotels — cotations, vols, hôtels
  • · périmètre de projet (#605, 2026-08-29)

    sous un projet à excluded_url_prefixes, serpapi_search écarte les résultats correspondants — quel que soit le moteur — et le dit (excluded_by_perimeter). les verticaux à contrat propre (jobs, trends, finance, flights, hotels) ne rendent pas de pages web et ne sont pas filtrés. détail : docs/projects.md.

    ⚙ plusieurs comptes

    ce connecteur accepte plusieurs comptes : chaque credential posé devient un compte nommé (un nom par compte), à ton niveau, à celui de ton équipe ou de ton org.

  • le premier n'a pas besoin de nom ; à partir du deuxième, chacun porte le sien (le premier prend alors le nom « principal », renommable)
  • sans précision, l'agent prend le seul compte posé, sinon celui marqué par défaut ; sinon l'appel est refusé en nommant les comptes disponibles — jamais un choix au hasard
  • viser un compte pour un appel : _account="<nom>" sur l'outil ; les lister : oto_identity(op='list', connector='serpapi') (scope='org' ou scope='group' pour ceux de l'org ou de l'équipe)
  • fixer le défaut : oto_identity(op='set', connector='serpapi', identity_id='<nom>') ; renommer : op='rename' avec new_name
  • ⚠️ aucun outil ne parcourt les comptes tout seul : un total sur plusieurs comptes s'obtient en appelant chacun (_account) et en additionnant
  • outils

    chargement…

    utilisation

    claude code — installe le plugin oto — claude plugin marketplace add otomata-tech/oto-plugin — mcp + skill configurés.
    claude.ai — branche mcp.oto.cx/mcp en connecteur custom (guide)
    cli — pipx install oto-cli puis oto serpapi …