atproto-ingest

Ingest Bluesky AT Protocol data into structured schemas and DB-ready artifacts.

60|13|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/plurigrid/asi --skill atproto-ingest
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atproto-ingest
Source: https://github.com/plurigrid/asi/tree/main/skills/atproto-ingest
Command: npx skills add https://github.com/plurigrid/asi --skill atproto-ingest

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Layer 1 - Data Acquisition for Bluesky/AT Protocol social graph and content.

Core Features & Use Cases

  • fetch-user-posts: resolve handles, fetch author feeds
  • get-engagement-graph: collect likes, reposts, replies, and quotes
  • stream-mentions: real-time monitoring of mentions
  • extract-thread-tree: full thread extraction for analysis
  • get-follower-network: first- and second-order connections

Quick Start

Authenticate with Bluesky (App Password or OAuth), then fetch a user’s posts, build engagement graphs, and stream notifications for real-time insights.

Frequently Asked Questions about atproto-ingest

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ingest Bluesky posts and build a social graph from AT Protocol data?

Ingest AT Protocol data by authenticating with Bluesky via app password or OAuth, then use xRPC endpoints to fetch user posts, map engagement (likes, reposts, replies), and extract follower networks. The Skill normalizes this into structured schemas ready for analytics, indexing, or moderation workflows.

Can I monitor mentions and notifications in real time from Bluesky?

Yes, stream mentions in real time using AT Protocol xRPC endpoints with pagination and rate-limiting support. The Skill captures notifications and real-time engagement data, enabling live monitoring for analytics and content tracking workflows.

What authentication methods does AT Protocol data ingestion support?

AT Protocol ingestion supports app-password authentication and OAuth with Bluesky xRPC endpoints. Both methods enable secure, rate-limited access to posts, engagements, threads, and follower data for downstream analysis.

How do I extract full thread trees from Bluesky for analysis?

Extract complete thread trees by fetching linked posts and replies through AT Protocol xRPC endpoints, then normalize the hierarchical structure into database-ready artifacts. This supports content analysis, moderation, and engagement mapping workflows.

Do I need pagination and rate limiting when fetching large volumes of Bluesky data?

Yes, AT Protocol ingestion includes built-in pagination and rate-limiting to handle large-scale data fetches from Bluesky reliably. This prevents throttling and ensures consistent data collection across posts, engagements, and follower networks.

What structured outputs does AT Protocol ingestion produce?

The Skill normalizes Bluesky posts, engagement graphs, thread trees, mentions, and follower networks into structured schemas and database-ready formats. These artifacts integrate directly into analytics, indexing, moderation, and monitoring systems.