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

Claude Code · Social Media

How to Use Cosmos public profile in Claude Code

Fetch a public Cosmos profile's bio, links, follower count, following count, and public post count. Use it to brief a design team on a public curator or refresh account summaries without retrieving individual posts.

Prompts to try with Cosmos public profile in Claude Code

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

Use Cosmos public profile for @design and add its bio and returned social links to our project's design research notes.

Cosmos public profileClaude Code
Try asking
  • Use Cosmos public profile for @design and create a small account summary component showing its bio, follower count, following count, and public post count.

  • Use Cosmos public profile for @design and compare its current bio with the description in our resource directory. Prepare an edit if they differ.

  • Use Cosmos public profile for @design and update the account counts in our project's existing research report.

  • Use Cosmos public profile for @design and check which Instagram, X, and TikTok links are returned. Add the available links to our design references file.

How to set up Cosmos public 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 Cosmos public 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/cosmos-profile",
        "input": {
          "handle": "design"
        }
      }'

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

Cosmos public profile providers and prices

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

ScrapeCreatorsSocial Media
Cosmos · Profile
scrapecreators/cosmos-profile

What can you do with Cosmos public profile in Claude Code?

Build a public curator reference into your project's design documentation using Cosmos bios, links, and account counts. A coding agent can compare those results with existing project copy and prepare focused edits.

Prepare a curator briefing

Summarize a public design curator's bio, linked accounts, and follower count before an editorial planning meeting.

Refresh a design resource directory

Review the bios and social links of public curator accounts already selected for a design resource directory.

Compare public account positioning

Compare the bios of selected public design accounts to identify differences in how they describe their focus.

Report account growth

Compare follower and public post counts across repeated observations of public brand accounts to prepare a weekly audience report.

Review linked social channels

List the Instagram, X, and TikTok links returned for a public curator account so an editor can choose where to continue research.

Check a brand's public description

Compare a brand's Cosmos bio against its approved description and flag wording that needs an editorial review.

Questions about Cosmos public profile in Claude Code

Can Claude Code use Cosmos public profile?

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

How much does Cosmos public 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 Cosmos public profile in Claude Code?

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

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

Does Claude Code wait while Cosmos public profile runs?

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

Which Cosmos profiles does this cover?

The endpoint covers public Cosmos profiles. Cosmos's privacy policy classifies information shared through its public sharing features as public, subject to applicable law.

Does every profile include social links?

No. The documented Cosmos example has null values for all three linked social accounts: Instagram, X, and TikTok.

How fresh is the profile information?

ScrapeCreators says it fetches the latest available Cosmos information when you make a request. That describes retrieval at request time, rather than a daily or weekly refresh schedule.

Does public visibility mean automated collection is permitted?

No. Section 8(F) of Cosmos's terms restricts automated access, searching, and downloading, while excepting Cosmos-provided software or search agents and generally available third-party browsers. Public visibility alone does not establish permission for automated collection.

Get started

Start using Cosmos public 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