How to Use Cosmos public profile in opencode
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 opencode
Copy an example into opencode, 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.
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 opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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: opencode 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.
What can you do with Cosmos public profile in opencode?
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.
More on Cosmos public profile and opencode
Cosmos public profile in other agents
Questions about Cosmos public profile in opencode
Can opencode use Cosmos public profile?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Cosmos public profile like any built-in tool.
How much does Cosmos public profile cost in opencode?
$0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.
Do I need a ScrapeCreators account to use Cosmos public profile in opencode?
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 opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while Cosmos public profile runs?
Cosmos public profile runs in the background. opencode 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.
Start using Cosmos public profile in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


