Spiral gives your agent every tool with one account. Browse the tools →

VS Code · Social Media

How to Use Bluesky user posts in VS Code

Fetch a Bluesky account's posts with text, author details, embeds, and counts for likes, replies, reposts, and quotes. Use it to summarize an organization's updates or compare engagement across its returned posts.

Prompts to try with Bluesky user posts in VS Code

Copy an example into VS Code, or ask in your own words.

Use Bluesky user posts for espn.com and add a table to this project showing returned post text, likes, replies, reposts, and quotes.

Bluesky user postsVS Code
Try asking
  • Use Bluesky user posts for bsky.app and build a view that groups the returned announcements by topic, with each post's URI.

  • Use Bluesky user posts for espn.com and add an export of external link titles, descriptions, and destination URLs wherever those embeds are present.

  • Use Bluesky user posts for bsky.app and adapt this project's importer to identify repeated posts by URI while updating their engagement counts.

  • Use Bluesky user posts for espn.com and create a chart comparing likes, replies, reposts, and quotes across the returned posts.

How to set up Bluesky user posts in VS Code

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the hosted server

    Use Add to VS Code on the console's Agents & MCP page, or run:

    code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
  2. Sign in

    VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

Use the Spiral skill

  1. Send VS Code this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Bluesky user posts

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "scrapecreators",
        "model": "scrapecreators/bluesky-user-posts",
        "input": {
          "handle": "espn.com"
        }
      }'

Then paste one of the prompts above: VS Code finds Bluesky user posts on Spiral, shows the price and runs it.

Bluesky user posts providers and prices

Spiral runs Bluesky user posts through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Bluesky · Posts
scrapecreators/bluesky-user-posts

What can you do with Bluesky user posts in VS Code?

Build an organization update dashboard from Bluesky post text, embeds, and engagement counts. A coding agent can connect the returned records to your project's views and use post URIs to identify repeated results.

Organization update digest

Summarize an organization's returned posts into a brief of announcements, recurring topics, and supporting post references.

Post engagement comparison

Compare likes, replies, reposts, and quotes across a brand's returned posts to identify which messages drew each kind of response.

Publisher link review

Collect the external links and preview titles present in a publisher's post embeds, then group them by subject for editorial review.

Announcement monitoring

Check an organization's feed on a schedule and flag newly returned posts that mention a launch, policy change, or service update.

Campaign message audit

Find campaign phrases in a business account's returned posts and compare the associated engagement counts.

Public post dashboard

Build a dashboard of an organization's post text, embedded content, and engagement counts, using post URIs to identify repeated results.

Questions about Bluesky user posts in VS Code

Can VS Code use Bluesky user posts?

Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Bluesky user posts like any built-in tool.

How much does Bluesky user posts cost in VS Code?

$0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your VS Code plan is separate.

Do I need a ScrapeCreators account to use Bluesky user posts in VS Code?

No. Spiral runs Bluesky user posts on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up Bluesky user posts in VS Code?

About two minutes: add the hosted server, then sign in.

Does VS Code wait while Bluesky user posts runs?

Bluesky user posts runs in the background. VS Code starts the run, checks on it and gives you the json when it's ready.

Is this public content?

Yes. Bluesky's privacy policy explicitly states that posts and comments are public; this endpoint retrieves an account's post feed.

Does Bluesky separate posts by hosting server?

Bluesky combines posts from many servers. Its company FAQ says server choice does not determine what content you can see.

Does the indexing timestamp tell me when a post was published?

The indexing timestamp generally means an API server first saw the record. Bluesky says edits can also update it, so it is not a guaranteed publication time.

What happens to deleted posts?

Bluesky says deleted posts disappear immediately from its user-facing app, while stored text takes longer to erase. The app's visible feed and underlying storage therefore have different deletion timing.

Does public access give me ownership of the posts?

No. Bluesky's terms explicitly leave ownership with the author; fetching a public post does not transfer that ownership.

Get started

Start using Bluesky user posts in VS Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into VS Code:

Set up VS Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options