← Back to Skills Marketplace
Instagram Search
by
Avital Yachin
· GitHub ↗
· v1.1.1
3057
Downloads
6
Stars
6
Active Installs
3
Versions
Install in OpenClaw
/install instagram-search
Description
Instagram Search — Search 400M+ Instagram posts, reels, and profiles. Find influencers, track hashtags, analyze engagement, and export data. No Instagram API or Meta developer account needed — works through Xpoz MCP.
README (SKILL.md)
Instagram Search
Search 400M+ Instagram posts and reels — captions AND video subtitles.
Find influencers, track hashtags, discover content trends, and export results. No Meta developer account, no Instagram Graph API setup, no app review process.
⚡ Setup
👉 Follow xpoz-setup — handles auth automatically.
Setup
Run xpoz-setup skill. Verify: mcporter call xpoz.checkAccessKeyStatus
What You Can Search
| Tool | What It Does |
|---|---|
getInstagramPostsByKeywords |
Search posts & reels by keywords |
getInstagramUsersByKeywords |
Find users posting about a topic |
getInstagramUser |
Look up a specific profile |
searchInstagramUsers |
Find accounts by display name |
getInstagramPostsByAuthor |
Get a user's post history |
Quick Examples
Search Posts & Reels
mcporter call xpoz.getInstagramPostsByKeywords \
query="sustainable fashion" \
startDate=2026-01-01 \
limit=100
# Poll for results:
mcporter call xpoz.checkOperationStatus operationId=op_abc123
Xpoz indexes both captions and video subtitles — so you can find reels by what people say, not just what they type.
Find Influencers by Topic
mcporter call xpoz.getInstagramUsersByKeywords \
query="fitness transformation OR workout routine" \
limit=200
Look Up a Profile
mcporter call xpoz.getInstagramUser \
identifier=natgeo \
identifierType=username
Search by Display Name
mcporter call xpoz.searchInstagramUsers query="National Geographic" limit=20
Boolean Queries
mcporter call xpoz.getInstagramPostsByKeywords \
query="(vegan OR plant-based) AND recipe NOT sponsored"
CSV Export
Every search generates a full export. Poll the dataDumpExportOperationId for a CSV download URL (up to 64K rows).
Why Not Use the Instagram API Directly?
| Instagram Graph API | Xpoz Instagram Search | |
|---|---|---|
| Setup | Meta developer account + app review | One-click Xpoz auth |
| Keyword search | ❌ Not available | ✅ Full-text + subtitles |
| Find influencers | Only if you know their username | Search by topic/content |
| Reels content | Metadata only | Captions + spoken words |
| Export | Manual pagination | One-click CSV |
| Cost | Free but painful setup | Free tier available |
The Instagram Graph API doesn't support keyword search at all. Xpoz fills that gap.
Related Skills
- xpoz-social-search — Cross-platform (Twitter + Instagram + Reddit)
- expert-finder — Find domain experts
- social-lead-gen — Find potential customers
Website: xpoz.ai • Free tier available • No Meta developer account needed
Built for ClawHub • 2026
Usage Guidance
What to check before installing:
- Confirm the xpoz-setup skill: inspect its SKILL.md and ensure it performs an OAuth flow and does not exfiltrate other secrets.
- Verify the mcporter npm package: check the npm registry publisher, package repository, recent commits, and popularity. Prefer packages from an official project org or GitHub repo. Consider installing in a sandbox first.
- Network endpoint: SKILL.md references mcp.xpoz.ai; validate that domain and review Xpoz's privacy/terms to understand what data will be sent and stored.
- Expect a binary (mcporter) to be written to your PATH; if you cannot trust the package, do not install it globally.
- OAuth scopes: when using xpoz-setup, review the OAuth scopes requested and avoid granting excessive account access.
- If you have low tolerance for third-party indexing/scraping, audit exports and CSV URLs before downloading, and monitor network activity to mcp.xpoz.ai.
Because of the metadata mismatch (registry did not list the xpoz-setup dependency or network host), proceed only after verifying those pieces; if you cannot inspect xpoz-setup or mcporter, treat the skill as higher risk.
Capability Analysis
Type: OpenClaw Skill
Name: instagram-search
Version: 1.1.1
The skill bundle is benign. All instructions in `SKILL.md` are consistent with its stated purpose of providing Instagram search functionality via the Xpoz.ai platform. It instructs the agent to install the `mcporter` binary via `npm` and use it to interact with the `xpoz` service. There are no signs of prompt injection, data exfiltration beyond expected search results, persistence mechanisms, or other malicious behaviors. The external dependencies (`mcporter` and `xpoz.ai`) are explicitly declared and align with the skill's description.
Capability Assessment
Purpose & Capability
The described functionality (searching Instagram via Xpoz MCP) is coherent with requiring a CLI (mcporter) and an Xpoz account; SKILL.md explicitly lists a dependency on xpoz-setup and network access to mcp.xpoz.ai. However, the registry metadata at the top did not list the xpoz-setup skill or the network host, which is an inconsistency that should be clarified.
Instruction Scope
Runtime instructions are narrowly scoped: they call the mcporter CLI (e.g., mcporter call xpoz.*) and instruct the user to run the xpoz-setup skill for OAuth. The SKILL.md does not instruct the agent to read unrelated files, environment variables, or system paths.
Install Mechanism
The install spec installs an npm package ('mcporter') which will create a binary on disk. Installing CLI tools via npm is common but higher-risk than instruction-only skills because it writes and executes code; verify the package source, publisher, and integrity before installing.
Credentials
Top-level registry metadata lists no required env vars or credentials, but SKILL.md states auth is handled via the xpoz-setup skill (OAuth 2.1) and that a Xpoz account is required. The credential requirement is present in the SKILL.md but not surfaced at the registry level — this mismatch should be remedied so users know an external account and OAuth flow will be used.
Persistence & Privilege
The skill does not request always-on presence and does not claim to modify other skills or system-wide settings. It will install a CLI binary (mcporter) but otherwise doesn't request elevated privileges or permanent agent-level presence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install instagram-search - After installation, invoke the skill by name or use
/instagram-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
Added setup section
v1.1.0
Added auto-install spec for mcporter
v1.0.0
- Initial release of Instagram Search skill.
- Search 400M+ Instagram posts, reels, and profiles by keywords, including captions and video subtitles.
- Find influencers, track hashtags, analyze engagement, and export full search results to CSV.
- No Instagram API or Meta developer account required — works via Xpoz MCP with OAuth-based setup.
- Includes multiple search tools: by keywords, user profile, author history, and display name.
- Integrates with related skills for cross-platform and lead generation searches.
Metadata
Frequently Asked Questions
What is Instagram Search?
Instagram Search — Search 400M+ Instagram posts, reels, and profiles. Find influencers, track hashtags, analyze engagement, and export data. No Instagram API or Meta developer account needed — works through Xpoz MCP. It is an AI Agent Skill for Claude Code / OpenClaw, with 3057 downloads so far.
How do I install Instagram Search?
Run "/install instagram-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Instagram Search free?
Yes, Instagram Search is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Instagram Search support?
Instagram Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Instagram Search?
It is built and maintained by Avital Yachin (@atyachin); the current version is v1.1.1.
More Skills