How to Use Instagram profile summary in Claude Code
Returns a profile summary with a biography, avatar, verification status, follower and following counts, and recent-post previews. Use it to compare public brands or creators without collecting a full post history.
Prompts to try with Instagram profile summary in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Instagram profile summary for @lego and @nike, then build a comparison table in this project with their biographies, verification status, and follower counts.
Use Instagram profile summary to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Instagram profile summary and tell me what changed since last week.
Check Instagram profile summary and summarize what you find in three bullet points.
Pull the newest data from Instagram profile summary and give me the result as a table.
How to set up Instagram profile summary in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code 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 profile summary
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": "tikhub", "model": "tikhub/instagram-v3-get-user-brief", "input": { "user_id": "791258468", "username": "99brasil" } }'
Then paste one of the prompts above: Claude Code finds Instagram profile summary on Spiral, shows the price and runs it.
Instagram profile summary providers and prices
Spiral runs Instagram profile summary through TikHub. Open a card for today's price, with every fee included.
What can you do with Instagram profile summary in Claude Code?
Build an Instagram research view that puts retrieved posts or account records into your project's existing components. Turn captions, media, embeds, or public account context into reviewable examples for a brand research workflow.
Build a creator partnership shortlist
Start with similar-account recommendations and recommended Reels. Review public creators' biographies, account background, and connections to an approved list of organizations before choosing candidates for manual review.
Prepare an editorial source check
Inspect a referenced post's caption, publisher, media, and publication time. Add the publisher's profile summary and account background, then prepare an embed for the editorial draft.
Write a campaign performance brief
Compare selected campaign posts' captions and engagement counts, add embeds as examples, and summarize the publishing brand's profile. Check returned likers and followers only against a predefined list of public business accounts.
Map connections between public brands
Compare returned followers, followed accounts, and post likers against an approved roster of brands and organizations. Add similar-account suggestions, profile summaries, and account background for a business research map.
Review your brand's public presence
Check your brand's profile summary, account background, and selected posts. Review returned follower, following, and liker lists against your public partner roster to prepare an internal account review.
More on Instagram profile summary and Claude Code
Overview
Instagram profile summary in other agents
Questions about Instagram profile summary in Claude Code
Can Claude Code use Instagram profile summary?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Instagram profile summary like any built-in tool.
How much does Instagram profile summary cost in Claude Code?
$0.0104 per request. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need a TikHub account to use Instagram profile summary in Claude Code?
No. Spiral runs Instagram profile summary on its own TikHub account. You sign in to Spiral once and never paste a key.
How long does it take to set up Instagram profile summary in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Instagram profile summary runs?
Instagram profile summary runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.
Does this cover private Instagram content?
TikHub describes its Instagram coverage as public data from public accounts. Private account content falls outside that coverage.
How fresh is the Instagram data?
TikHub describes the Instagram series used here as real-time and recommends it for up-to-the-minute counts. Its older visitor-view series can lag by a few days.
Why might engagement counts be lower than in Instagram?
TikHub says its results include Instagram engagement only. The app can show a combined Instagram and Facebook total.
Does access include permission to republish the content?
TikHub's terms state that retrieved content may carry third-party intellectual property rights. Retrieving a caption, photo, video, or embed does not establish ownership of that content.
Are the results guaranteed to be accurate and complete?
TikHub's terms explicitly disclaim a guarantee that returned data is accurate, complete, or current. Its description of this Instagram series as real-time is not a completeness warranty.
Start using Instagram profile summary in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


