Glasser

Visão Geral

Glasser é um intermediário de API comercial que expõe provedores de dados de terceiros através de uma CLI e uma conta. Use-o para preencher uma lacuna de dados após verificar as ferramentas gratuitas do ambiente e as integrações existentes do usuário. A saída do provedor mantém sua estrutura nativa, portanto, inspecione o endpoint selecionado antes de cada execução.

Esta habilidade foi contribuída por um membro da equipe Glasser.

Quando Usar Esta Habilidade

• Use quando uma tarefa precisar de dados atuais da web, notícias, busca, social, negócios, pessoas, lugares, compras, imagens, vídeos ou enriquecimento que as ferramentas disponíveis não possam fornecer.
• Use quando o usuário desejar acesso pago por chamada sem criar uma conta separada com o provedor subjacente.
• Use para fluxos de trabalho de marketing e pesquisa que necessitam de evidências estruturadas de um provedor de dados nomeado.
• Prefira a escolha explícita do provedor pelo usuário, chaves de API existentes, integrações instaladas e ferramentas gratuitas antes do Glasser.

Como Funciona

Passo 1: Verificar Disponibilidade e Autenticação

Use a CLI apenas se ela já estiver instalada ou se o usuário tiver aprovado sua instalação de acordo com a política de instalação de software do ambiente host. As instruções de instalação são mantidas em https://glasser.ai/SKILL.md?utm_source=agentic-awesome-skills&utm_medium=skill. Não baixe ou instale código executável sem a revisão e aprovação exigidas pelo ambiente atual.

Verifique a CLI e a conta:

glasser --version
glasser balance

Se a autenticação estiver faltando em uma sessão interativa, execute glasser login. Ele abre um fluxo de dispositivo baseado em navegador. Transmita a URL e o código impressos pela CLI e aguarde a conclusão do comando. Nunca peça ao usuário para colar uma Chave no chat.

Para ambientes não supervisionados, o usuário pode configurar GLASSER_API_KEY através do gerenciador de segredos do ambiente. Nunca escreva isso em um arquivo de projeto ou inclua em um argumento de comando.

Passo 2: Descobrir Endpoints Candidatos

Pesquise por capacidade em vez de adivinhar um provedor ou endpoint:

glasser search -q "Google search results"
glasser search -q "company enrichment"
glasser search -q "Reddit posts and comments"

Compare o provedor, o endpoint e o preço listado. Os resultados da pesquisa são classificados por relevância; a classificação não é uma recomendação de qualidade ou preço.

Passo 3: Inspecionar o Contrato

Inspecione o endpoint exato antes de construir a entrada:

glasser inspect -p serper -e /search

Registre:

• o preço atual e todas as cláusulas de cobrança;
• campos de entrada obrigatórios e opcionais;
• campos que controlam o volume do resultado;
• modo de execução e tempo limite;
• o provedor que receberá a solicitação.

Esquemas, preços e cláusulas de cobrança podem mudar. O resultado ao vivo de inspect é o contrato para a próxima execução.

Passo 4: Autorizar o Escopo Pago

Apenas run gasta o saldo do espaço de trabalho. Antes da primeira chamada paga, mostre ao usuário o provedor, o endpoint, o preço por chamada, as exceções de cobrança, o escopo de entrada e o volume de resultado solicitado. Aguarde a aprovação, a menos que o usuário já tenha fornecido um escopo ou orçamento exato que cubra a chamada.

Crie a entrada JSON nativa do provedor em um arquivo após a inspeção. Um arquivo evita erros de cotação do shell e mantém a solicitação revisável. Não inclua dados pessoais, confidenciais ou credenciais não relacionados.

Passo 5: Executar e Recuperar com Segurança

Execute a solicitação aprovada:

glasser run -p serper -e /search -f request.json --wait

A CLI imprime uma Chave de Idempotência. Se um tempo limite ou falha de transporte deixar o resultado incerto, repita a solicitação com a mesma chave:

glasser run -p serper -e /search -f request.json --idempotency-key <same-key> --wait

Não crie uma nova chave para uma tentativa ambígua. Isso pode criar e cobrar uma segunda execução. Para uma execução conhecida, use glasser runs get -r <run-id> --wait em vez de iniciar outra.

Passo 6: Relatar Evidências e Custo

Para cada execução usada na resposta, relate:

1. o provedor e o endpoint;
2. o status da execução do Glasser;
3. o que diz a resposta do provedor;
4. o Charge exato impresso pela CLI;
5. o Run URL privado impresso pela CLI.

COMPLETED significa que o provedor respondeu. Isso não garante que o provedor encontrou um resultado, portanto, descreva o status da execução e o payload.

Exemplos

Exemplo 1: Pesquisar uma Página de Resultados de Busca

Find a Google SERP endpoint in Glasser, show me its current price and input
schema, and ask before running one query for "best email marketing tools".

O agente pesquisa no catálogo, inspeciona o endpoint selecionado, obtém pago

…