# Bluesky Reader

> Read public Bluesky feeds via AT Protocol API.

- **Type:** Skill
- **Install:** `agentstack add skill-notque-vexjoy-agent-bluesky-reader`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [notque](https://agentstack.voostack.com/s/notque)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [notque](https://github.com/notque)
- **Source:** https://github.com/notque/vexjoy-agent/tree/main/skills/content/bluesky-reader
- **Website:** https://vexjoy.com

## Install

```sh
agentstack add skill-notque-vexjoy-agent-bluesky-reader
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Bluesky Reader Skill

Read public Bluesky profiles via the AT Protocol public API. No auth needed.

## Commands

```bash
# Fetch recent posts
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --limit 20

# Search posts by keyword (fetches feed, filters locally)
python3 ~/.claude/scripts/bluesky_reader.py search --handle HANDLE --query "search terms"

# JSON output for pipeline consumption
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --json

# Pagination
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --cursor CURSOR_STRING
```

## API Details

- **Endpoint**: `https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed`
- **Auth**: None (public endpoint)
- **Limit**: 1-100 posts per request
- **Search**: Local keyword filter -- all query words must appear (case-insensitive)

## When to Use

- Gathering recent Bluesky posts from a specific person for research
- Searching a profile's posts for mentions of a topic
- Feeding Bluesky content into a news or content pipeline

## Reference Loading

| Task type | Load this reference |
|-----------|-------------------|
| Endpoint details, data shapes, pagination | `references/at-protocol-api.md` |
| Debugging fetch errors, wrong output, missing posts | `references/at-protocol-preferred-patterns.md` |
| Extending the script with new endpoints or search | `references/at-protocol-api.md` |
| Code review of AT Protocol Python code | `references/at-protocol-preferred-patterns.md` |

## Exit Codes

| Code | Meaning |
|------|---------|
| 0    | Success |
| 1    | Error (network failure, invalid handle, no posts found) |

## Reference Loading Table

| Signal | Load These Files | Why |
|---|---|---|
| Endpoint details, data shapes, pagination | `at-protocol-api.md` | Routes to the matching deep reference |
| Debugging fetch errors, wrong output, missing posts | `at-protocol-preferred-patterns.md` | Routes to the matching deep reference |
| Extending the script with new endpoints or search | `at-protocol-api.md` | Routes to the matching deep reference |
| Code review of AT Protocol Python code | `at-protocol-preferred-patterns.md` | Routes to the matching deep reference |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [notque](https://github.com/notque)
- **Source:** [notque/vexjoy-agent](https://github.com/notque/vexjoy-agent)
- **License:** MIT
- **Homepage:** https://vexjoy.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-notque-vexjoy-agent-bluesky-reader
- Seller: https://agentstack.voostack.com/s/notque
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.