[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [X (Twitter) Community](https://spiral.ai/integrations/gemini-cli/x-twitter-community)

# How to Use X (Twitter) Community in Gemini CLI

Fetch an X community’s name, description, size, rules, creation time, joining policy, and creator details. Use it to assess a community before participating or compare its details over time; posts come from a separate endpoint.

|  |  |
| --- | --- |
| Model | X (Twitter) Community |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with X (Twitter) Community in Gemini CLI

- Use X community details for https://x.com/i/communities/1926186499399139650 and add its name, description, and size to our project’s community directory.
- Fetch https://x.com/i/communities/1926186499399139650 with X community details and build a rules panel in our app using the returned rule names and descriptions.
- Use X community details for https://x.com/i/communities/1926186499399139650 and add its joining policy to our existing community card.
- Retrieve https://x.com/i/communities/1926186499399139650 through X community details, save its size, and add a comparison against our last saved observation.
- Use X community details for https://x.com/i/communities/1926186499399139650 to populate a community overview in our project with its description, creation time, and rules.

## How to set up X (Twitter) Community in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 X (Twitter) Community**: 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/twitter-community",
    "input": {
      "url": "https://x.com/i/communities/1926186499399139650"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds X (Twitter) Community on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## X (Twitter) Community tools and prices

- [X (Twitter) · Community](https://spiral.ai/tools/scrapecreators/scrapecreators/twitter-community) (ScrapeCreators): Up to $0.0013 per run.

## What can you do with X (Twitter) Community in Gemini CLI?

Build a community directory that displays X descriptions, sizes, and rules. A coding agent can add the returned details to your project and implement comparisons between saved observations.

### Check community fit

Summarize an X community’s description and rules to decide whether a product tutorial belongs there.

### Prepare a participation brief

Turn the returned rules into a checklist for a brand’s community manager before they draft a contribution.

### Measure community growth

Compare community size across saved observations and calculate the change between checks.

### Watch joining policy changes

Compare the returned joining policy with an earlier observation and flag changes for the team planning to participate.

### Maintain a community directory

Refresh names, descriptions, sizes, and rules for a curated list of X communities.

### Detect changes in community purpose

Compare descriptions and rules over time to identify when a community’s stated focus changes.

### Build a community details panel

Populate a research application with a community’s name, description, size, creation time, and joining policy.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## X (Twitter) Community in other agents

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

## More Gemini CLI guides

- [Twitch creator search](https://spiral.ai/integrations/gemini-cli/twitch-creator-search)
- [X (Twitter) Search Posts](https://spiral.ai/integrations/gemini-cli/x-twitter-search-posts)
- [Twitch creator profile](https://spiral.ai/integrations/gemini-cli/twitch-creator-profile)
- [X (Twitter) account background](https://spiral.ai/integrations/gemini-cli/x-twitter-account-background)
- [Twitch creator connected accounts](https://spiral.ai/integrations/gemini-cli/twitch-creator-connected-accounts)
- [X (Twitter) account followers](https://spiral.ai/integrations/gemini-cli/x-twitter-account-followers)

## Questions about X (Twitter) Community in Gemini CLI

**Can Gemini CLI use X (Twitter) Community?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run X (Twitter) Community like any built-in tool.

**How much does X (Twitter) Community cost in Gemini CLI?**

Up to $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 X (Twitter) Community in Gemini CLI?**

No. Spiral runs X (Twitter) Community on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

**How long does it take to set up X (Twitter) Community in Gemini CLI?**

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

**Does Gemini CLI wait while X (Twitter) Community runs?**

X (Twitter) Community runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**What does an X community details response contain?**

It includes the community’s name, description, identifier, size, creation time, joining policy, rules, and creator profile. The documented result describes one community.

**How fresh are the community details?**

ScrapeCreators says it fetches the latest information available from X when you make a request. That is the provider’s freshness claim, rather than a stated update interval.

**Does the response include community posts?**

Posts have a separate Community Tweets endpoint. Use community details for the community’s description, size, joining policy, and rules.

**How many rules can an X community have?**

X requires at least one rule and allows up to ten at a time. This gives a concrete boundary for a rules summary.

**Can X community search provide a complete directory?**

No. X explicitly says that not all available communities appear in search results, so a shortlist assembled through search has that coverage limit.

