How to Use Cosmos public profile in Gemini CLI
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 Gemini CLI
Copy an example into Gemini CLI, 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 Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI 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: Gemini CLI 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 Gemini CLI?
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 Gemini CLI
Cosmos public profile in other agents
Questions about Cosmos public profile in Gemini CLI
Can Gemini CLI use Cosmos public profile?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Cosmos public profile like any built-in tool.
How much does Cosmos public profile cost in Gemini CLI?
$0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.
Do I need a ScrapeCreators account to use Cosmos public profile in Gemini CLI?
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 Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Cosmos public profile runs?
Cosmos public profile runs in the background. Gemini CLI 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 Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


