~/social/bluesky-scraper

Bluesky Scraper — Posts, Perfis, Feeds e Interações

Extraia posts, perfis, seguidores, feeds, threads e listas de curtidas e republicações do Bluesky via AT Protocol — além de busca autenticada e resultados de hashtags com uma app password. JSON limpo e normalizado.

social TypeScriptAT Protocol Global
proooxy/bluesky-scraper — especificações
categoriasocial / social
linguagemTypeScript
stackTypeScript, AT Protocol
mercadosGlobal
saídaJSON limpo e pronto para RAG

principais recursos

Onze modos — search, profile, posts, followers, following, feed, thread, likers, reposters, actorLikes e hashtag

API pública sem necessidade de credenciais para perfis, posts, seguidores, contas seguidas, feeds, threads, curtidas e republicações

Modos autenticados com app password — busca, hashtag e curtidas da própria conta

Exportação de engajamento por post — listas completas de quem curtiu e quem republicou cada post

Achatamento de threads — percorre uma árvore de respostas até uma profundidade configurável

Paginação automática por cursor em todos os endpoints de lista, até o seu limite de itens

Formato JSON normalizado para posts e perfis em todos os modos

HTTP resiliente — throttling de requisições, backoff exponencial e retry em 429/5xx

casos de uso

  • Monitoramento de marca e palavras-chave via busca autenticada
  • Rastreamento de hashtags e tendências na rede
  • Exportação de audiência — listas de seguidores e contas seguidas de um criador ou marca
  • Análise de engajamento — exatamente quem curtiu ou republicou um determinado post
  • Construção de datasets para BI, analytics ou pipelines de RAG a partir de JSON limpo e normalizado
  • Arquivamento de conversas e threads a partir de um post

parâmetros de entrada

ParâmetroTipoObrigatórioDescrição
modestringopcionalO que raspar: posts, profile, followers, following, feed, thread, likers, reposters, actorLikes, search ou hashtag (padrão: posts).
handlesarrayopcionalHandles do Bluesky para os modos profile/posts/followers/following/actorLikes, ex.: bsky.app.
querystringopcionalTexto de busca (modo search) ou hashtag (modo hashtag — com # adicionado automaticamente).
postUristringopcionalURI AT de um post — usado pelos modos thread, likers e reposters.
feedUristringopcionalURI AT de um feed personalizado — usado pelo modo feed.
identifierstringopcionalHandle/e-mail de login do Bluesky para modos autenticados (search, hashtag, actorLikes).
appPasswordstringopcionalApp password do Bluesky (não a sua senha principal) para os modos autenticados.
maxItemsnumberopcionalMáximo de posts/perfis salvos; cada um é um evento cobrado (padrão: 100).

Exemplo de Saída

 1{
 2  "itemType": "post",
 3  "mode": "posts",
 4  "uri": "at://did:plc:.../app.bsky.feed.post/...",
 5  "author": {
 6    "did": "did:plc:...",
 7    "handle": "bsky.app",
 8    "displayName": "Bluesky",
 9    "followersCount": 1234567
10  },
11  "text": "Example post text",
12  "createdAt": "2026-06-11T00:00:00Z",
13  "replyCount": 10,
14  "repostCount": 20,
15  "likeCount": 100,
16  "langs": ["en"],
17  "url": "https://bsky.app/profile/bsky.app/post/..."
18}

Preços

Pagamento por evento: $0.001 por item (post ou perfil) salvo. Uma exportação de 1,000 itens é ~$1.00, e maxItems limita tanto o volume quanto o custo.

Dicas

  • Comece pelos modos públicos. Perfis, posts, seguidores e engajamento (likers/reposters) não exigem login — reserve a autenticação por app password para execuções de search e hashtag.
  • Exporte engajamento, não só posts. Os modos likers e reposters revelam exatamente quem amplificou um post — um sinal que a maioria dos scrapers de Bluesky ignora.
  • Limite maxItems em extrações de seguidores/contas seguidas de contas grandes para manter as execuções rápidas e os custos previsíveis.

faq

Preciso de credenciais do Bluesky?
Só para os modos search, hashtag e actorLikes — gere uma app password nas configurações do Bluesky e informe-a em appPassword. Os modos profile, posts, followers, following, feed, thread, likers e reposters funcionam sem credenciais, via API pública do AT Protocol.
Posso exportar as curtidas de qualquer conta?
Não. A API do Bluesky só expõe actorLikes para a própria conta autenticada, então o handle e o identificador de login precisam se referir à mesma conta.
Como encontro a URI de um post ou feed?
URIs AT têm o formato at://did:plc:.../app.bsky.feed.post/... — copie-as da saída da API do Bluesky ou de ferramentas de desenvolvedor. URIs de feed usam a coleção app.bsky.feed.generator.
É seguro usar minha app password?
Sim — use uma app password do Bluesky (criada em Settings → App Passwords), nunca a sua senha principal. Ela é restrita em escopo, revogável e enviada como um input secreto.

relacionados em ~/social

Execute Bluesky Scraper — Posts, Perfis, Feeds e Interações ou solicite um projeto personalizado

Comece a extrair dados no Apify em minutos, ou me contrate para desenvolver um scraper sob medida e um pipeline de RAG para sua fonte e esquema exatos.

executar no Apify obter dados personalizados