Live Web Data by Teneo Protocol
oficialServidor MCP remoto e API que busca qualquer página pública da web em tempo real, da forma como os visitantes locais a veem, no país que você escolher, em Markdown limpo. Extração de dados da web, busca e scraping para agentes de IA, com resultados locais e preços por solicitação. livewebdata.com é a Live Web Data API, um produto do Teneo Protocol.
O que você pode fazer com Live Web Data By Teneo Protocol MCP?
- Busque conteúdo de páginas ao vivo — Peça ao seu assistente para ler qualquer URL pública e retornar o conteúdo principal em Markdown limpo, texto simples ou HTML.
- Escolha o país de visualização — Solicite uma página como ela é exibida em um país específico, como
de,gbouus, usando um código ISO-3166 alfa-2. - Controle o tamanho e o escopo da saída — Defina
max_charactersentre 500 e 100.000 e escolha entre o conteúdo principal compacto ou o corpo completo da página. - Verifique o status da conta — Peça ao assistente para verificar os créditos restantes, o plano e o limite de requisições antes de executar grandes lotes; essa chamada é gratuita.
- Lide com erros de busca — Receba mensagens de erro úteis para sites restritos, páginas não encontradas, tempos limite, limites de requisições e créditos insuficientes.
Servidor MCP hospedado
npx add-mcp 'https://livewebdata.com/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Use a API Live Web Data como ferramenta no Claude, Cursor, VS Code e qualquer outro cliente MCP — com uma URL e sua chave de API atual.
O que é MCP
O Model Context Protocol (MCP) é um padrão aberto que permite que agentes de IA descubram e chamem ferramentas externas. Nosso servidor MCP expõe a Contents API como duas ferramentas, para que um agente possa ler qualquer página pública da web por conta própria.
Servidor e autenticação
| Valor | |
|---|---|
| URL do servidor | https://livewebdata.com/mcp |
| Transporte | HTTP com streaming (sem estado): JSON-RPC sobre POST; GET e DELETE respondem 405 |
| Autenticação | Authorization: Bearer <api_key> |
| Chaves | As mesmas chaves da API REST — crie uma em Chaves de API |
Chaves ausentes ou inválidas são rejeitadas com HTTP 401 (contas suspensas: 403, "O acesso à API desta conta está suspenso. Entre em contato com o suporte.") antes da execução de qualquer ferramenta.
Configuração do cliente
Substitua YOUR_KEY pela sua chave de API. No painel, a página Integrações preenche sua chave automaticamente.
Execute isto no terminal. O servidor ficará disponível em todas as sessões do Claude Code deste projeto.
claude mcp add --transport http live-web-data https://livewebdata.com/mcp \
--header "Authorization: Bearer YOUR_KEY"
Adicione --scope user para disponibilizá-lo em todos os projetos. Verifique com claude mcp list.
get_page_contents
Busca uma página pública da web em tempo real e retorna seu conteúdo principal como Markdown limpo, texto simples ou HTML. Somente leitura, idempotente. Uma URL por chamada.
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
url | string (http/https, no máximo 8,192 caracteres) | obrigatório | A URL pública a ser buscada. |
country | ISO-3166 alpha-2 | "us" | Busca a página como ela é exibida neste país, por exemplo, 'de', 'gb', 'us'. |
format | "markdown" | "text" | "html" | "markdown" | Formato de saída. Prefira markdown. O HTML da página é buscado e retornado somente para "html". |
max_characters | inteiro 500–100000 | 8000 | Número máximo de caracteres do conteúdo a retornar. Menor que o padrão da API REST (text.maxCharacters, 100,000), pois o resultado é inserido no contexto do agente; aumente esse valor quando o conteúdo for cortado. |
verbosity | "compact" | "full" | "compact" | compact = somente conteúdo principal, full = corpo inteiro da página. |
O resultado é um único item de texto com um cabeçalho curto, seguido pelo conteúdo. O JSON completo no estilo REST também é retornado como structuredContent (com results[].html somente para format: "html").
# Web scraping - Wikipedia
Source: https://en.wikipedia.org/wiki/Web_scraping · country: us · live · credits used: 1 · credits left: 8,411
# Web scraping - Wikipedia
…
get_account_status
Verifica os créditos restantes, o plano e o limite de requisições da conta conectada. Os agentes devem chamá-la antes de grandes lotes. Sem parâmetros, gratuita. Retorna os mesmos valores que GET /v1/account.
Plan: Starter · Credits left: 8,412 · Rate limit: 2 URL/s (burst 4) · Status: active
Erros
Os erros são retornados com isError: true e uma frase com uma ação que o agente pode seguir. Quando nenhuma cobrança foi feita, a mensagem termina com “Nenhum crédito foi cobrado.”
| Caso | Mensagem para o agente |
|---|---|
| Destino restrito 451 | Este site é restrito e não pode ser acessado. Não tente novamente; use outra fonte. |
CRAWL_NOT_RENDERED | A página não tem texto utilizável: ela precisa de renderização de JavaScript ou não exibe texto mesmo após a renderização. Tente outra fonte ou uma URL diferente para encontrar a mesma informação. |
CRAWL_NOT_FOUND | Página não encontrada (404/410). |
SOURCE_NOT_AVAILABLE | O site recusou esta solicitação. Use outra fonte. |
SOURCE_BLOCKED | O site negou o acesso. Use outra fonte. |
CRAWL_LIVECRAWL_TIMEOUT | A página excedeu o tempo limite. Tente novamente uma vez com um tempo limite maior; caso contrário, use outra fonte. |
BROWSER_UNAVAILABLE | A renderização do navegador está temporariamente indisponível. Tente novamente em alguns minutos; caso contrário, use outra fonte. |
RATE_LIMITED | O limite de renderização do plano do usuário foi atingido. Não tente renderizar novamente agora; use outra fonte. |
| 402 créditos insuficientes | A conta está sem créditos. Peça ao usuário para adicionar créditos em …/dashboard/billing. |
| 429 limite de requisições atingido | Limite de requisições atingido. Aguarde N segundos antes de tentar novamente. |
| 401 / 403 | A chave de API é inválida ou está suspensa. Peça ao usuário para verificar a chave em …/dashboard/keys. |
| Ainda buscando após 5 minutos | O carregamento da página não foi concluído em 5 minutos, e a busca ainda poderá ser cobrada. Use outra fonte. |
Créditos
As chamadas MCP são cobradas exatamente como as chamadas REST: 1 crédito por página acessada com sucesso; solicitações com falha (incluindo acesso negado pelo site) são gratuitas. Elas aparecem em Uso com o canal mcp. Consulte Créditos.