How to Use Instagram creator posts in Windsurf
Fetch recent Instagram posts with captions, media links, timestamps, and engagement metrics, in fixed pages of 12. Use it to review a creator's content and find posts worth examining individually.
Prompts to try with Instagram creator posts in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Instagram creator posts for @natgeo and add a recent-content table to the project with captions, dates, post links, and available engagement metrics.
Use Instagram creator posts to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Instagram creator posts and tell me what changed since last week.
Check Instagram creator posts and summarize what you find in three bullet points.
Pull the newest data from Instagram creator posts and give me the result as a table.
How to set up Instagram creator posts in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- 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" } } } - 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
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf 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 Instagram creator 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": "alexandria", "model": "influencers-club/instagram/creator-posts", "input": { "url": "<url>" } }'
Then paste one of the prompts above: Windsurf finds Instagram creator posts on Spiral, shows the price and runs it.
Instagram creator posts providers and prices
Spiral runs Instagram creator posts through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Count | a number | count |
Every API field of Influencers.club · Instagram creator posts is on its tool page: open its card above.
What can you do with Instagram creator posts in Windsurf?
Build an internal creator research view with profile evidence, connected accounts, or recent Instagram content. Add the returned records to the project's existing review workflow so campaign decisions link back to public accounts and posts.
Build a campaign shortlist
Find US outdoor creators, check their profiles, inspect recent posts and individual campaign examples, and map their connected accounts. Produce an internal shortlist with evidence for each recommendation.
Review a creator before a partnership
Compare potential partners through search, verify profile information, review recent content, examine selected posts, and identify connected accounts. Give the partnership team a source-linked review of public creator activity.
Research examples for a content brief
Discover cooking creators, use profile niches to narrow the list, and review recent recipe posts and selected reels. Include connected accounts as possible places to extend the campaign.
Refresh an internal creator roster
Recheck partner profiles and connected accounts, review recent posts, and inspect selected content for the next campaign. Search for additional creators in the same market to keep the roster useful.
Compare recent publishing activity
Review recent posts from public publishers such as National Geographic and NASA. Compare captions, publishing dates, and available engagement metrics, then examine individual posts that deserve a closer look.
More on Instagram creator posts and Windsurf
Overview
Instagram creator posts in other agents
Questions about Instagram creator posts in Windsurf
Can Windsurf use Instagram creator posts?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Instagram creator posts like any built-in tool.
How much does Instagram creator posts cost in Windsurf?
Up to $0.0139672 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 an Alexandria account to use Instagram creator posts in Windsurf?
No. Spiral runs Instagram creator posts on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up Instagram creator posts in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Instagram creator posts runs?
Instagram creator posts runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.
Does Influencers.club include private Instagram information?
Its creator database uses publicly available information from the public internet and data partners. The creator privacy notice says it does not collect information from behind a login or password wall.
How often does Influencers.club refresh creator profiles?
Influencers.club says every profile is revisited weekly, with faster-changing accounts checked more often. That is a profile refresh policy, not a promise that every post metric updates continuously.
How many Instagram posts come back at once?
Instagram creator posts returns a fixed page of 12 posts. The source does not allow a larger Instagram page size.
Are audience demographics measured directly?
Influencers.club describes audience figures as aggregate estimates extrapolated from public engagement signals. They describe the engaged audience rather than a complete census of everyone who follows an account.
Why can engagement metrics be zero or missing?
The source says a metric Instagram does not expose can return as zero or null. Hidden likes, views, or comments and platform visibility restrictions are documented causes.
Start using Instagram creator posts in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


