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

Claude Code · Social Media

How to Use Bluesky profile in Claude Code

Fetch a public Bluesky account’s bio, avatar, DID, follower and post counts, and verification data. Use it to compare brand audiences, check account identity, or refresh a publisher directory.

Prompts to try with Bluesky profile in Claude Code

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

Use Bluesky profile for espn.com and add its returned DID, bio, avatar reference, and audience totals to this project’s publisher directory.

Bluesky profileClaude Code
Try asking
  • Use Bluesky profile for espn.com and washingtonpost.com, then build a comparison table of follower, following, and post totals in the dashboard.

  • Use Bluesky profile for bsky.app and save its reported list, feed generator, and starter pack counts in the project’s research dataset.

  • Use Bluesky profile for espn.com and compare its bio and avatar reference with the saved record in this repository.

  • Use Bluesky profile for washingtonpost.com and add its returned verification data to the account review view.

How to set up Bluesky profile in Claude Code

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

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude 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 profile

    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-profile",
        "input": {
          "handle": "espn.com"
        }
      }'

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

Bluesky profile providers and prices

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

ScrapeCreatorsSocial Media
Bluesky · Profile
scrapecreators/bluesky-profile

What can you do with Bluesky profile in Claude Code?

Build a publisher directory with Bluesky bios, avatars, and audience totals. A coding agent can match records by DID and calculate changes from saved observations.

Compare publisher audiences

Compare follower, following, and post totals for a selected list of public publishers before deciding which accounts merit closer editorial research.

Measure audience changes

Save repeated follower totals for public brand accounts and calculate changes between observations for a weekly audience report.

Refresh a publisher directory

Update account descriptions and avatar references for a directory of public media organizations, matching records by DID.

Review brand identity signals

Inspect a public business account’s DID, description, domain username, and verification data before adding it to a research brief.

Check a brand refresh

Compare a brand’s returned bio and avatar reference with an earlier observation to identify profile changes after a rebrand.

Compare community publishing tools

Compare the reported counts of lists, feed generators, and starter packs across selected public organizations.

Questions about Bluesky profile in Claude Code

Can Claude Code use Bluesky profile?

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

How much does Bluesky profile cost in Claude 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 Claude Code plan is separate.

Do I need a ScrapeCreators account to use Bluesky profile in Claude Code?

No. Spiral runs Bluesky profile 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 profile in Claude Code?

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

Does Claude Code wait while Bluesky profile runs?

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

Are Bluesky profiles public?

Bluesky’s published FAQ states that there are no private profiles. The profile lookup returns public account information.

How fresh is the profile data?

ScrapeCreators says it fetches the latest available Bluesky information when a request is made. That describes retrieval freshness; it does not establish a guaranteed delay between an account change and its appearance in the response.

Does a follower count include the accounts following the profile?

The documented response provides follower, following, and post totals. Those totals are counts, not lists of accounts or post records.

Does public access transfer ownership of profile content?

No. Bluesky’s terms state that users retain ownership of their content, so public availability should not be treated as a blanket reuse license.

Get started

Start using Bluesky profile in Claude Code

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

Paste this into Claude Code:

Set up Claude Code

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