Torobjo
The Torobjo MCP Server is a powerful implementation of the Model Context Protocol (MCP) for product search and Instagram analysis. It integrates with the Torob API for product searches and extracts captions from Instagram, featuring a modular design
What is Torobjo?
Torobjo is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to torobjo mcp server is a powerful implementation of the model context protocol (mcp) for product search and instagram analysis. it integrates with the torob api for product searches and extracts captio...
The Torobjo MCP Server is a powerful implementation of the Model Context Protocol (MCP) for product search and Instagram analysis. It integrates with the Torob API for product searches and extracts captions from Instagram, featuring a modular design
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- The Torobjo MCP Server is a powerful implementation of the M
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx torobjomcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Torobjo
The Torobjo MCP Server is a FastMCP-based implementation that combines Torob.com product price comparison search with Instagram caption extraction. It provides two primary tools: search_torob for querying the Persian-language Torob product comparison API with price filtering and pagination, and get_instagram_caption for headless browser extraction of Instagram post captions with automatic retry and fallback logic.
Prerequisites
- Python 3.10 or later
- pip or uv for package management
- A Chromium-compatible browser installed (for headless Instagram scraping via the instacaption tool)
- Git to clone the repository
- Claude Desktop or another MCP-compatible client
Clone the repository
Clone the TorobjoMCP repository from GitHub.
git clone https://github.com/TahaBakhtari/TorobjoMCP.git
cd TorobjoMCPCreate a virtual environment and install dependencies
Set up a Python environment and install the required packages.
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install fastmcp httpx playwright
python -m playwright install chromiumReview the main server file
The entry point is torob_mcp_server.py which registers both MCP tools via FastMCP. The Torob search uses the Torob public API and the Instagram tool uses instacaption.py with headless Playwright.
# Tools registered in torob_mcp_server.py:
# - search_torob(query, page=1, min_price=None, max_price=None)
# - get_instagram_caption(url)Configure Claude Desktop
Add the server to claude_desktop_config.json pointing to your local Python interpreter and the server script.
{
"mcpServers": {
"torobjomcp": {
"command": "/path/to/TorobjoMCP/venv/bin/python",
"args": ["torob_mcp_server.py"],
"cwd": "/path/to/TorobjoMCP"
}
}
}Restart Claude Desktop and test
Restart Claude Desktop and verify both tools are available by asking Claude to search for a product on Torob.
# Test in Claude Desktop:
"Search Torob for iPhone 15 and show me the top results with prices"Torobjo Examples
Client configuration
Claude Desktop claude_desktop_config.json for the Torobjo MCP server using a local Python virtual environment.
{
"mcpServers": {
"torobjomcp": {
"command": "/home/user/TorobjoMCP/venv/bin/python",
"args": ["torob_mcp_server.py"],
"cwd": "/home/user/TorobjoMCP"
}
}
}Prompts to try
Example prompts for the Torob product search and Instagram caption extraction tools.
- "Search Torob for Samsung Galaxy S24 and show me the cheapest options"
- "Find laptop prices on Torob filtered between 10,000,000 and 20,000,000 Tomans"
- "Get the caption from this Instagram post: https://www.instagram.com/p/example"
- "Search Torob for AirPods Pro on page 2 of results"
- "Compare headphone prices on Torob and summarize the top 5 cheapest"Troubleshooting Torobjo
search_torob returns empty results or connection errors
The tool queries the Torob.com API which serves Persian-language product data. Ensure your network can reach torob.com. Rate limiting may trigger on rapid successive queries—the server includes automatic retry logic, but adding a short delay between requests helps.
get_instagram_caption fails or returns empty string
Instagram's DOM structure changes frequently. Ensure Playwright and Chromium are installed via `python -m playwright install chromium`. The tool uses multiple fallback selectors, but heavily restricted or private Instagram posts cannot be scraped. Verify the URL is publicly accessible.
ModuleNotFoundError for fastmcp or playwright on startup
Make sure the Python interpreter path in your MCP config points to the venv where you installed dependencies, not the system Python. Double-check by running `/path/to/venv/bin/python -c 'import fastmcp; import playwright'` in a terminal.
Frequently Asked Questions about Torobjo
What is Torobjo?
Torobjo is a Model Context Protocol (MCP) server that torobjo mcp server is a powerful implementation of the model context protocol (mcp) for product search and instagram analysis. it integrates with the torob api for product searches and extracts captions from instagram, featuring a modular design It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Torobjo?
Follow the installation instructions on the Torobjo GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Torobjo?
Torobjo works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Torobjo free to use?
Yes, Torobjo is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Torobjo Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Torobjo? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Torobjo in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Torobjo?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.