[Integrations](https://spiral.ai/integrations) › [Grok Build](https://spiral.ai/integrations/grok-build) › [Cosmos collection posts](https://spiral.ai/integrations/grok-build/cosmos-collection-posts)

# How to Use Cosmos collection posts in Grok Build

Get public posts saved to a specific Cosmos collection, including captions, source links, media details, and save timestamps where available. Use it to review a curated reference board or compare its contents over time.

|  |  |
| --- | --- |
| Model | Cosmos collection posts |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Cosmos collection posts in Grok Build

- Use Cosmos collection posts for https://www.cosmos.so/design/the-best-band-posters and create a reference index in this project with the returned post IDs, captions, post links, and source links.
- Use Cosmos collection posts for https://www.cosmos.so/design/words-on-cakes and add a report to this project showing image widths, heights, and calculated aspect ratios.
- Use Cosmos collection posts for https://www.cosmos.so/design/the-best-band-posters and compare the returned post IDs with the project's previous collection snapshot. Report newly observed IDs.
- Use Cosmos collection posts for https://www.cosmos.so/design/words-on-cakes and create a CSV in this project with each returned post's caption, creation timestamp, save timestamp, and source link.
- Use Cosmos collection posts for https://www.cosmos.so/design/the-best-band-posters and https://www.cosmos.so/design/words-on-cakes. Add a project report listing shared post IDs and the IDs unique to each collection.

## How to set up Cosmos collection posts in Grok Build

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

### Use Spiral's MCP server

1. **Add the server**: Add `--scope project` to add Spiral to the current repository only. No header and no client ID or secret: Grok registers itself with Spiral.

```bash
grok mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `grok` and run `/mcps`. Select Spiral and press `i`. Your browser opens: sign in to Spiral, pick the organization and click Authorize. No API key.

3. **Check it**

```bash
grok mcp doctor spiral
```

### Use the Spiral skill

1. **Send Grok Build 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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Cosmos collection posts**: One request; the result comes back by polling or a webhook.

```bash
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-cluster-posts",
    "input": {
      "url": "https://www.cosmos.so/design/the-best-band-posters"
    }
  }'
```

Then paste one of the prompts above: Grok Build finds Cosmos collection posts on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/grok-build

## Cosmos collection posts tools and prices

- [Cosmos · Collection Posts](https://spiral.ai/tools/scrapecreators/scrapecreators/cosmos-cluster-posts) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cursor |  | — | Pass the previous response cursor unchanged. Stop when it is null; sending the literal string "null" returns an empty terminal page without fetching or charging. |

## What can you do with Cosmos collection posts in Grok Build?

Build a reference index from a public Cosmos collection using post IDs, captions, source links, and media dimensions. A coding agent can add collection comparisons and aspect-ratio summaries to a project, subject to Cosmos's restrictions on automated access.

### Prepare a poster reference brief

Review posts in Design's the best band posters collection and organize the returned captions and source links into a reference list for a poster design discussion.

### Compare collection snapshots

With permission for automated access, compare post IDs across repeated retrievals of a public design collection and report newly observed references.

### Build a source-link checklist

Extract available source links from collection posts so a researcher can inspect the referenced pages before requesting permission to reuse an image.

### Review image proportions

Calculate aspect ratios from returned media dimensions and separate portrait, landscape, and square references for a layout discussion.

### Find overlap between reference boards

Compare returned post IDs from two public collections to identify shared references and posts unique to each board.

### Prepare a lettering discussion

Turn the returned captions and post links from Design's words on cakes collection into a reading list for a lettering workshop.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Grok Build guides](https://spiral.ai/integrations/grok-build)

## Cosmos collection posts in other agents

- [Amp](https://spiral.ai/integrations/amp/cosmos-collection-posts)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/cosmos-collection-posts)
- [Claude](https://spiral.ai/integrations/claude-desktop/cosmos-collection-posts)
- [Claude Code](https://spiral.ai/integrations/claude-code/cosmos-collection-posts)
- [Cline](https://spiral.ai/integrations/cline/cosmos-collection-posts)
- [Codex](https://spiral.ai/integrations/codex/cosmos-collection-posts)
- [Cursor](https://spiral.ai/integrations/cursor/cosmos-collection-posts)
- [Devin](https://spiral.ai/integrations/devin/cosmos-collection-posts)
- [dots](https://spiral.ai/integrations/dots/cosmos-collection-posts)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/cosmos-collection-posts)
- [Gemini](https://spiral.ai/integrations/gemini/cosmos-collection-posts)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/cosmos-collection-posts)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/cosmos-collection-posts)
- [goose](https://spiral.ai/integrations/goose/cosmos-collection-posts)
- [Grok](https://spiral.ai/integrations/grok/cosmos-collection-posts)
- [Hermes](https://spiral.ai/integrations/hermes/cosmos-collection-posts)
- [Instinct](https://spiral.ai/integrations/instinct/cosmos-collection-posts)
- [Manus](https://spiral.ai/integrations/manus/cosmos-collection-posts)
- [Muse](https://spiral.ai/integrations/muse/cosmos-collection-posts)
- [Muse Code](https://spiral.ai/integrations/muse-code/cosmos-collection-posts)
- [n8n](https://spiral.ai/integrations/n8n/cosmos-collection-posts)
- [Notion](https://spiral.ai/integrations/notion/cosmos-collection-posts)
- [OpenClaw](https://spiral.ai/integrations/openclaw/cosmos-collection-posts)
- [opencode](https://spiral.ai/integrations/opencode/cosmos-collection-posts)
- [Perplexity](https://spiral.ai/integrations/perplexity/cosmos-collection-posts)
- [Raycast](https://spiral.ai/integrations/raycast/cosmos-collection-posts)
- [VS Code](https://spiral.ai/integrations/vscode/cosmos-collection-posts)
- [Windsurf](https://spiral.ai/integrations/windsurf/cosmos-collection-posts)
- [Zapier](https://spiral.ai/integrations/zapier/cosmos-collection-posts)

## More Grok Build guides

- [Cosmos collection details](https://spiral.ai/integrations/grok-build/cosmos-collection-details)
- [Cosmos post details](https://spiral.ai/integrations/grok-build/cosmos-post-details)
- [Bluesky user posts](https://spiral.ai/integrations/grok-build/bluesky-user-posts)
- [Cosmos post search](https://spiral.ai/integrations/grok-build/cosmos-post-search)
- [Bluesky profile](https://spiral.ai/integrations/grok-build/bluesky-profile)
- [Cosmos public profile](https://spiral.ai/integrations/grok-build/cosmos-public-profile)

## Questions about Cosmos collection posts in Grok Build

**Can Grok Build use Cosmos collection posts?**

Yes. Add Spiral to Grok Build as an MCP server, and Grok Build can find and run Cosmos collection posts like any built-in tool.

**How much does Cosmos collection posts cost in Grok Build?**

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

**Do I need a ScrapeCreators account to use Cosmos collection posts in Grok Build?**

No. Spiral runs Cosmos collection 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 Cosmos collection posts in Grok Build?**

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

**Does Grok Build wait while Cosmos collection posts runs?**

Cosmos collection posts runs in the background. Grok Build starts the run, checks on it and gives you the json when it's ready.

**Can this retrieve private Cosmos collections?**

The endpoint covers public collection posts. Cosmos says private collections are visible only to their owner and invited collaborators, and the all-elements collection is private too.

**How fresh are the collection contents?**

ScrapeCreators says it fetches the latest available Cosmos information when a request is made. That describes a request-time fetch, not a fixed daily or weekly update schedule.

**Does one response contain the entire collection?**

The endpoint supports pagination, and its documented example explicitly indicates that more results remain. The example total of 46 is a collection count, not a promised number of posts per call.

**Does Cosmos limit how much a collection can contain?**

Cosmos says there is no cap on elements, saves, or collections. That platform policy does not specify the endpoint's page size.

**Can I reuse images from a public collection?**

Public visibility does not grant reuse permission. Cosmos requires explicit permission from the creator or rights holder for use, reproduction, or distribution beyond personal inspiration.

