Links que seu agente não consegue abrir: Xiaohongshu, Douyin, TikTok, YouTube e X como ferramenta MCP

Publicado originalmente em linkdigest.dev, onde eu construo isso.

O problema, em um parágrafo

Cole um link do Xiaohongshu, Douyin, TikTok, YouTube ou X em um agente de IA e ele busca a URL, obtém uma tela de download de aplicativo ou um muro de login, e diz que não há nada lá. Não está errado. O conteúdo dessas postagens é vídeo, imagens e texto impresso dentro de imagens, atrás de links de compartilhamento tokenizados — nada disso está no HTML que uma busca retorna. Remova as <script> tags de uma nota real do Xiaohongshu e 264 caracteres de navegação permanecem.

O que o LinkDigest faz a respeito

LinkDigest é um leitor hospedado: uma chamada transforma o link em texto que um LLM pode usar — uma transcrição com códigos de tempo, o texto na tela, uma descrição e OCR de cada imagem, a legenda e os metadados — como Markdown ou JSON. É um servidor MCP (claude mcp add --transport http linkdigest https://linkdigest.dev/mcp --header "Authorization: Bearer $KEY"), uma API REST e um console web. Medido em uma nota do Xiaohongshu com 17 imagens: 17 imagens descritas e lidas, 381 fragmentos de texto na tela, 13 pontos-chave, 119 segundos. Três digests são gratuitos, sem cartão.

O que não faz, declarado de antemão: o Bilibili recusa o endereço do nosso servidor (HTTP 412), o Instagram está conectado, mas não verificado, o Facebook está fora do escopo. Um digest que não conseguiu ler parte de uma postagem diz isso em um campo degraded em vez de retornar um resultado ralo silenciosamente — e um digest que não leu nada não custa nada.

Seu agente é bom em ler. Ele apenas não consegue abrir metade da internet.

Entregue ao Claude Code um link do Xiaohongshu de uma revisão de design, um vídeo do Douyin que um colega enviou, um TikTok que seu concorrente postou — e ele busca a URL, obtém uma tela de download de aplicativo e diz que não conseguiu encontrar nada útil. Não está errado. Realmente não há nada lá.

[Diagrama: A mesma URL retorna uma tela de download de aplicativo para uma busca simples, e a nota real para o LinkDigest.]

Este é um post sobre a segunda caixa: como chamá-la, e três coisas que as pessoas realmente fazem com ela.

O agente a chama, não você

Um comando:

claude mcp add --transport http linkdigest \
  https://linkdigest.dev/mcp \
  --header "Authorization: Bearer ld_live_..."

Isso registra uma ferramenta, digest_url(url, format, job_id). Apenas url é obrigatório.

A parte que importa é o que acontece a seguir: você nunca menciona isso novamente. A descrição da ferramenta diz ao agente para chamá-la sempre que encontrar um link social que não consegue ler, então o agente a acessa por conta própria, no meio da tarefa, da mesma forma que acessa grep.

[Diagrama: O agente chama o servidor MCP, que chama o motor, e a transcrição retorna ao agente.]

O Cursor leva o mesmo servidor em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "linkdigest": {
      "url": "https://linkdigest.dev/mcp",
      "headers": { "Authorization": "Bearer ld_live_..." }
    }
  }
}

O que realmente volta

Não é um resumo. As partes:

curl -X POST https://linkdigest.dev/api/v1/digest \
  -H "Authorization: Bearer ld_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://v.douyin.com/..."}'

Uma resposta real, reduzida — este é um vídeo do Douyin, executado contra a produção enquanto escrevia este parágrafo:

platform           'douyin'
author             '逸蒙的赛博空间'
posted_at          '2026-08-27'
transcript_source  'asr'
cached             True   credits 0
degraded           []
transcript[0]      {"t": 0, "text": "谁能想到，就这么一个丑萌小玩意儿…"}
key_points[0]      "该AI产品名为Tolen，主打「记住你」的核心功能…"

Quinze campos no total: platform, author, title, posted_at, caption, transcript, ocr_text, images, key_points, raw_markdown, source_url, transcript_source, degraded, além de cached e credits.

Dois desses valem a pena serem destacados.

transcript_source diz como você obteve as palavras — native_captions, asr, ou none. Legendas que a plataforma já tinha são exatas; o reconhecimento de fala não é. Um pipeline que trata esses de forma idêntica eventualmente citará um número mal ouvido como fato.

degraded é uma lista do que não funcionou completamente, em palavras simples. Vazio em uma execução limpa. Ele existe por causa de um bug específico: uma nota foi digerida durante uma tempestade de limite de taxa do provedor, cada lote de visão falhou, o manipulador por lote engoliu cada um, e o trabalho retornou images: 0, ocr: 0 — um resultado bem formado, completamente vazio, que foi então armazenado em cache por trinta dias. Nada a montante poderia distinguir uma resposta vazia de uma fácil. Agora pode.

O pipeline, e por que alguns links levam duas chamadas

[Diagrama: Quatro estágios: resolver, buscar, ler, estruturar.]

read é onde o tempo vai, porque é o único estágio que precisa assistir ou ouvir qualquer coisa. Medido: uma nota do Xiaohongshu com imagens leva de um a dois minutos; um vídeo do YouTube com legendas cerca de dois minutos e meio.

Isso é mais longo do que uma solicitação HTTP deve esperar, então a API devolve o trabalho:

POST /api/v1/digest
→ 202 {"pending":true,"jobId":"abc…","poll":"/api/v1/digest/abc…","retryAfter":15}

Coleta com a mesma chave naquele caminho poll — 202 enquanto executa, 200 com o