bluesky-research
Researches Bluesky profiles, posts, follower/follows graphs, account search, and trending topics via the Crawlora API, returning clean JSON. Use when the user wants a Bluesky account's stats, a post's thread/engagement, a Bluesky account search, or what's trending on Bluesky — instead of scraping the app or the AT Protocol API directly.
Rank
62
Safety
84
Downloads
979
Updated
Oct 11, 2026
Version
1.0.17
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 979 downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 979 downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.17release · observed Sep 21, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 1.0.17release
Sync skill instructions, references, and helper from GitHub 0cfbceba40b050ba434a0a3f4945ca97b668c805
Observed Sep 21, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s17d53nb8nd03gyyfdy32rgde58e574f:bluesky-research- Install using `clawhub skill install s17d53nb8nd03gyyfdy32rgde58e574f:bluesky-research` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/crawlora-org/bluesky-research before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-bluesky-research/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
112,429 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
--- name: bluesky-research description: Researches Bluesky profiles, posts, follower/follows graphs, account search, and trending topics via the Crawlora API, returning clean JSON. Use when the user wants a Bluesky account's stats, a post's thread/engagement, a Bluesky account search, or what's trending on Bluesky — instead of scraping the app or the AT Protocol API directly. --- # Bluesky research Look up public Bluesky profiles, author feeds, post threads, follower/follows graphs, account search, and trending topics — all as normalized JSON from the Crawlora API, no app scraping or direct AT Protocol client needed. ## When to use this skill - "What's <handle>'s profile / follower count on Bluesky?" - "Pull <handle>'s recent posts on Bluesky." - "Show this Bluesky post's replies / thread." - "Who follows <handle> on Bluesky?" / "Who does <handle> follow?" - "Search Bluesky for accounts about <topic>." - "What's trending on Bluesky right now?" ## Setup (one-time) - Get a free Crawlora API key (2,000 credits/mo, no card) at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills). - Set `CRAWLORA_API_KEY` in the environment before running the helper. - The helper reads `CRAWLORA_API_KEY` from the environment and sends requests to `https://api.crawlora.net/api/v1`. Missing/invalid key → `401`. ## How it works Pick the job: 1. **Profile** — `/bluesky/profile` (`actor` = handle or DID). Display name, description, avatar/banner, follower/follows/posts counts. 2. **Author feed** — `/bluesky/author-feed` (`actor`, optional `cursor`, `limit`). A page of an account's posts, newest first, with engagement counts and any attached images/link card/quoted post. 3. **Post thread** — `/bluesky/post-thread` (`uri` = the post's `at://` URI, optional `depth`). The post plus its nested replies and, if it's a reply, its parent chain. 4. **Followers / follows graph** — `/bluesky/followers` and `/bluesky/follows` (`actor`, optional `cursor`, `limit`). Page through an account's followers or the accounts it follows. 5. **Search accounts** — `/bluesky/search-actors` (`q`, optional `cursor`, `limit`). Accounts matching a query against display name, handle, and profile description. 6. **Trending** — `/bluesky/trending-topics` (no params). Bluesky's current trending topics and suggested feeds. Full endpoint list, methods, and params: [`reference/endpoints.md`](reference/endpoints.md). ## Calling the API ```sh # Profile + author feed: scripts/crawlora.sh /bluesky/profile actor=bsky.app | jq '.' scripts/crawlora.sh /bluesky/author-feed actor=bsky.app limit=20 | jq '.' # Search + trending: scripts/crawlora.sh /bluesky/search-actors q="web scraping" | jq '.' scripts/crawlora.sh /bluesky/trending-topics | jq '.' ``` Use `scripts/crawlora.sh` for all requests; it keeps the API key out of command-line arguments. ## Endpoint reference See [`reference/endpoints.md`](reference/endpoin
_meta.json
{
"ownerId": "kn70shhkf6qpfwgfrbgtep2wkd8c6b4t",
"slug": "bluesky-research",
"version": "1.0.17",
"publishedAt": 1789954115213
}reference/endpoints.md
# bluesky-research — endpoint reference
> Generated from `scripts/tools.json` by `scripts/generate.mjs` — do not edit by hand.
Endpoints this skill uses, grouped by platform. Call them via `scripts/crawlora.sh` (see SKILL.md).
All paths are relative to the API base `https://api.crawlora.net/api/v1` and require the header `x-api-key: $CRAWLORA_API_KEY`. Path params like `{id}` are substituted into the URL; `GET` params go in the query string; `POST` params go in a JSON body.
**11 endpoints across 1 platform group(s).**
## Bluesky (11)
### `bluesky_author_feed`
- **HTTP:** `GET /bluesky/author-feed`
- **What:** A Bluesky account's posts. Returns a page of a Bluesky account's posts, newest first, including text, engagement counts, and any attached images/link card/quoted post. Public data, sourced from the AT Protocol's public, credential-free AppView API.
- **Params:** `actor` (string, **required**) — A handle (e.g. bsky.app) or DID; `cursor` (string, optional) — Pagination cursor from a previous response's cursor field; `limit` (integer, optional) — Page size, 1-100
### `bluesky_followers`
- **HTTP:** `GET /bluesky/followers`
- **What:** A Bluesky account's followers. Returns a page of a Bluesky account's followers. Public data, sourced from the AT Protocol's public, credential-free AppView API.
- **Params:** `actor` (string, **required**) — A handle (e.g. bsky.app) or DID; `cursor` (string, optional) — Pagination cursor from a previous response's cursor field; `limit` (integer, optional) — Page size, 1-100
### `bluesky_follows`
- **HTTP:** `GET /bluesky/follows`
- **What:** Accounts a Bluesky account follows. Returns a page of the accounts a Bluesky account follows. Public data, sourced from the AT Protocol's public, credential-free AppView API.
- **Params:** `actor` (string, **required**) — A handle (e.g. bsky.app) or DID; `cursor` (string, optional) — Pagination cursor from a previous response's cursor field; `limit` (integer, optional) — Page size, 1-100
### `bluesky_post_likes`
- **HTTP:** `GET /bluesky/post-likes`
- **What:** List actors who liked a Bluesky post. Returns public actors who liked a post, with an optional cursor for pagination.
- **Params:** `cursor` (string, optional) — Pagination cursor; `limit` (integer, optional) — Page size, 1-100; `uri` (string, **required**) — The post's at:// URI
### `bluesky_post_quotes`
- **HTTP:** `GET /bluesky/post-quotes`
- **What:** List quotes of a Bluesky post. Returns public posts that quote the specified post, with an optional cursor for pagination.
- **Params:** `cursor` (string, optional) — Pagination cursor; `limit` (integer, optional) — Page size, 1-100; `uri` (string, **required**) — The quoted post's at:// URI
### `bluesky_post_reposted_by`
- **HTTP:** `GET /bluesky/post-reposted-by`
- **What:** List actors who reposted a Bluesky post. Returns public actors who reposted a post, with an optional cursor for pagination.
- **Params:** `cursor` (string, optional) — Paginationskill-card.md
## Description: Researches Bluesky profiles, posts, follower/follows graphs, account search, and trending topics via the Crawlora API, returning clean JSON. This skill is ready for commercial/non-commercial use. ## Publisher: [crawlora-org](https://clawhub.ai/user/crawlora-org) ### License/Terms of Use: MIT-0 ## Use Case: Developers, analysts, and agents use this skill to retrieve public Bluesky profile, post, thread, graph, search, and trending-topic data through Crawlora instead of scraping the Bluesky app or calling the AT Protocol directly. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Using the skill sends Bluesky handles, post URIs, search terms, and the Crawlora API key to Crawlora. Mitigation: Use it only when that data sharing is acceptable, keep the API key in CRAWLORA_API_KEY, and avoid private or sensitive data. Risk: The skill is designed for public Bluesky data and may be unsuitable for private or sensitive investigations. Mitigation: Limit use to public Bluesky profiles, posts, graph data, account search, and trending topics. ## Reference(s): - [Endpoint reference](reference/endpoints.md) - [Crawlora](https://crawlora.net) - [ClawHub skill page](https://clawhub.ai/crawlora-org/skills/bluesky-research) ## Skill Output: **Output Type(s):** [text, markdown, shell commands, configuration, guidance] **Output Format:** [Markdown guidance with shell commands that return JSON from the Crawlora API] **Output Parameters:** [1D] **Other Properties Related to Output:** [Uses CRAWLORA_API_KEY and supports cursor-paginated public Bluesky endpoints.] ## Skill Version(s): 1.0.17 (source: server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/crawlora-org/skills/bluesky-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/skills/bluesky-research",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T23:07:26.581Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-bluesky-research/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-bluesky-research/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T23:07:26.581Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "979 downloads",
"href": "https://clawhub.ai/crawlora-org/bluesky-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/bluesky-research",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T23:07:26.581Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.17",
"href": "https://clawhub.ai/crawlora-org/bluesky-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/bluesky-research",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-21T01:28:35.213Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-bluesky-research/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-bluesky-research/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.17",
"description": "Sync skill instructions, references, and helper from GitHub 0cfbceba40b050ba434a0a3f4945ca97b668c805",
"href": "https://clawhub.ai/crawlora-org/bluesky-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/bluesky-research",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-21T01:28:35.213Z",
"isPublic": true
}
]
}Record generated Oct 12, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-crawlora-org-bluesky-research/run-check
