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

Windsurf · Social Media

How to Use Truth Social account posts in Windsurf

Fetch posts from an accessible public Truth Social account, with text, timestamps, post IDs, and reply, ReTruth, and like counts. Use it to review public statements across multiple posts and page through more results.

Prompts to try with Truth Social account posts in Windsurf

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

Use Truth Social account posts for realDonaldTrump and add a tariff statement chronology to this project's report generator. Include each matching post's text, ID, and creation timestamp.

Truth Social account postsWindsurf
Try asking
  • Use Truth Social account posts for realDonaldTrump to populate a table in this project showing retrieved energy policy posts and their separate reply, ReTruth, and like counts.

  • Use Truth Social account posts for realDonaldTrump and add pagination to this project's importer. Deduplicate by post ID and produce a summary of the dates covered by the retrieved records.

  • Use Truth Social account posts for realDonaldTrump to create a report in this repository comparing retrieved posts mentioning steel with posts mentioning aluminum. Show the matching text and timestamps.

  • Use Truth Social account posts for realDonaldTrump and add a claim review export to this project. Extract checkable claims about manufacturing, with the source post ID and timestamp for each.

How to set up Truth Social account posts in Windsurf

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

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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 Truth Social account posts

    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/truthsocial-user-posts",
        "input": {
          "trim": false
        }
      }'

Then paste one of the prompts above: Windsurf finds Truth Social account posts on Spiral, shows the price and runs it.

Truth Social account posts providers and prices

Spiral runs Truth Social account posts through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Truth Social · User Posts
scrapecreators/truthsocial-user-posts

Settings you can ask for

Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Trimon or off

Set to true for a trimmed down version of the response

Every API field of Truth Social · User Posts is on its tool page: open its card above.

What can you do with Truth Social account posts in Windsurf?

Build a dated policy briefing from public Truth Social statements, with post IDs behind each summary. A coding agent can add pagination and topic filtering to your project, then compare reply, ReTruth, and like counts.

Public statement chronology

Arrange retrieved statements about tariffs by their creation timestamps to see the sequence of announcements.

Policy briefing

Summarize an accessible public account's statements about energy policy, citing the post IDs behind each point.

Engagement comparison

Compare reply, ReTruth, and like counts across retrieved posts about the same policy topic.

Interview preparation

Find public statements about a specific proposal and turn them into interview questions grounded in the retrieved wording.

Statement comparison

Compare retrieved statements on a topic across two time periods, identifying changes in wording without assuming a change in policy.

Claim review queue

Extract checkable claims from public statements and retain their post IDs and timestamps for separate verification.

Questions about Truth Social account posts in Windsurf

Can Windsurf use Truth Social account posts?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Truth Social account posts like any built-in tool.

How much does Truth Social account posts cost in Windsurf?

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 Windsurf plan is separate.

Do I need a ScrapeCreators account to use Truth Social account posts in Windsurf?

No. Spiral runs Truth Social account 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 Truth Social account posts in Windsurf?

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

Does Windsurf wait while Truth Social account posts runs?

Truth Social account posts runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

How fresh are the posts?

ScrapeCreators says it fetches the latest available information when you make a request. That describes retrieval on request rather than a daily update schedule.

Do engagement counts include the actual replies?

The response documents separate totals for replies, ReTruths, and likes. A reply count is a number, not the text of the replies.

What does ReTruth mean?

A ReTruth is a reshared Truth. Accounts can reshare their own posts as well as posts from others, so a reshare should not automatically be attributed as newly written text.

Does public visibility allow unrestricted collection and reuse?

Truth Social's terms prohibit data mining and similar extraction tools and restrict commercial exploitation of content without express prior written permission. Public visibility does not itself grant those permissions.

Get started

Start using Truth Social account posts in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options