convez.ai
PluginIntegração & APIsIntermediário
rdhillbb

GoSerp

rdhillbb/goserp

Interface Go para buscas Google via Serper.dev com query rewriting

Ver no GitHub
InicialPluginScore · de 0 a 100

Pacote Go para integração com a API Serper.dev, permitindo buscas no Google programaticamente. Oferece busca básica e extensiva com reescrita automática de queries, suporte a answer boxes, resultados orgânicos, "Pessoas também perguntam" e buscas relacionadas, com deduplicação automática.

Instalação

$npx convez-ai rdhillbb/goserp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
1
Saúde
28%
Último commit
há 1 ano
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Integrar buscas Google em aplicações Go
  • Coletar resultados de busca estruturados programaticamente
  • Pesquisa automatizada com variações de query
  • Construir ferramentas de análise de SERPs

Veredito

GoSerp é uma integração bem estruturada para devs Go que precisam de buscas programáticas. A feature de extensive search com reescrita automática é diferencial, mas requer API key paga do Serper.dev.

README

A tradução para o português deste README ainda está na fila.

GoSerp

A Go package for performing Google searches using the Serper.dev API. This package provides both basic and extensive search capabilities with automatic query rewriting for deeper search results.

Features

  • Basic search functionality with duplicate URL filtering
  • Extensive search with query rewriting for comprehensive results
  • Support for answer boxes, organic results, "People Also Ask" sections, and related searches
  • Automatic deduplication of search results
  • Built-in rate limiting and timeout handling
  • Structured JSON response format

Installation

go get github.com/rdhillbb/goserp

Prerequisites

You need to set up the following environment variable:

export SERP_API_KEY=your_serper_api_key

Usage

Basic Search

package main

import (
    "fmt"
    "github.com/rdhillbb/goserp"
)

func main() {
    results, err := goserp.SerpSearch("What is Garlic")
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    fmt.Println(results)
}

Extensive Search

The extensive search feature automatically generates 15 related queries based on your initial search query, providing a more comprehensive set of results. For example, if you search for information about garlic and onions, it will create variations of the query to cover different aspects, benefits, and related topics.

results, err := goserp.SerpExtensiveSearch("What is Garlic? Is there a benefit for eating onions")
if err != nil {
    fmt.Println("Error:", err)
    return
}
fmt.Println(results)

This will generate multiple queries like:

  • Health benefits of garlic and onions
  • Nutritional composition of garlic
  • How to use garlic in cooking
  • Medicinal properties of alliums
  • Common uses for onions and garlic ...and more

The final results combine and deduplicate findings from all generated queries, providing a rich set of information about the topic.

Response Structure

The package returns results in the following JSON structure:

{
    "structureType": "serp",
    "timestamp": "RFC3339 formatted time",
    "credits": 0,
    "queries": [
        {
            "query": "original query",
            "answerBox": {
                "title": "string",
                "url": "string",
                "snippet": "string"
            },
            "organicResults": [...],
            "peopleAlsoAsk": [...],
            "relatedSearches": [...]
        }
    ]
}

Features

  • Answer Box: Direct answers from Google's featured snippets
  • Organic Results: Regular search results with title, URL, and snippet
  • People Also Ask: Related questions and answers
  • Related Searches: Similar search queries
  • Deduplication: Automatic removal of duplicate URLs across result types

License

MIT License

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Note

This package requires a valid Serper.dev API key. You can obtain one by signing up at https://serper.dev

Ver o original no GitHub

Bom para

Relacionados