bluesky-instructions

name	bluesky-instructions
type	instruction
description	Returns API instructions (not data) for retrieving Bluesky metrics via AT Protocol. Read the returned instructions, then use fetch-text + extract to get actual data.
schema_hint	{"target":"$variable (Bluesky handle, e.g. 'name.bsky.social')","out":"$variable (optional)"}

bluesky-instructions

Returns instructions for retrieving engagement metrics for a Bluesky account using the public AT Protocol API. This tool does NOT return metrics data — it returns API endpoints and usage patterns. Use fetch-text to call the endpoints described below, then extract or extract-struct to parse the JSON responses.

API Base URL

https://public.api.bsky.app/xrpc/

Endpoints

Profile Metrics

URL: https://public.api.bsky.app/xrpc/app.bsky.actor.getProfile?actor={HANDLE}

Returns: followersCount, followsCount, postsCount, displayName, description

Post Engagement (Author Feed)

URL: https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed?actor={HANDLE}&limit={N}

Returns per-post: likeCount, repostCount, , , post text, timestamp.