This server turns your Sell The Trend account into an AI-drivable product research engine by controlling a real browser, enabling comprehensive dropshipping niche research and automated PDF report generation.
Session Management
Check login/authentication status (stt_status)
Log in with human-in-the-loop Cloudflare verification (stt_login)
Persist browser sessions for future runs (stt_save_session)
Product Research
Search NEXUS by keyword/niche for structured product data — name, sell price, orders, and sales (stt_research)
Search for products by keyword and return raw product cards (stt_search_products)
Browse handpicked/winning products (stt_winning_products)
PDF Report Generation
Generate a detailed PDF dossier for any niche/keyword (stt_research_report), including:
Full product list with economics (cost, profit, saturation %)
Deep dives into top products with AI insights
Competitor stores with URLs and revenue
AliExpress supplier links
Facebook Ad Library links and targeting suggestions
Product images embedded in the report
Browser Automation Primitives
Navigate to any Sell The Trend page or URL (stt_navigate)
Take a text snapshot of the current page (stt_snapshot)
Extract data via CSS selectors (stt_extract)
Click elements by selector or visible text (stt_click)
Fill input fields and optionally submit forms (stt_fill)
Execute arbitrary JavaScript in the page context (stt_evaluate)
Capture PNG screenshots of the current page (stt_screenshot)
These low-level browser tools also give access to any dashboard area, including ad finders, spy tools, and store intelligence features.
Retrieves AliExpress supplier information for products discovered during Sell The Trend research.
Generates links to Facebook Ad Library and provides targeting data for products researched through Sell The Trend.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Sell The Trend MCP Research the catnip niche and give me a detailed PDF report."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP (Model Context Protocol) server that turns your Sell The Trend account into an AI-drivable product-research engine, and generates detailed, decision-ready PDF dossiers for any niche.
Sell The Trend has no public API, so this server drives your own logged-in account through a real browser (Playwright). It gives an AI assistant (Claude Code, etc.) generic browser primitives plus purpose-built research + reporting tools.
⚠️ Personal-use tool, your own paid account, your own data. Automating a SaaS dashboard can be against its Terms of Service. Use responsibly and at your own risk. Not affiliated with, or endorsed by, Sell The Trend.
🔎 stt_research: search NEXUS for a niche/keyword → structured product data (name, sell price, orders, sales).
📄 stt_research_report: research a keyword and generate a detailed PDF dossier: full product list + deep dossiers for the top products (cost, profit, saturation %, AI insights, competitor stores + revenue + URLs, AliExpress suppliers, Facebook Ad Library link, FB targeting, product image).
🧭 Browser primitives (stt_navigate, stt_snapshot, stt_extract, stt_click, stt_fill, stt_evaluate, stt_screenshot): reach anything in your dashboard (ad finders, spy tools, store intel…).
🔐 stt_login / stt_status: one-click human login (handles the "verify you are human" check) + session status.
Related MCP server: merch-connector
Node.js 18+
A Sell The Trend account (free trial works)
Claude Code (or any MCP client)
git clone https://github.com/mfahadiqbalofcl/sellthetrend-mcp.git
cd sellthetrend-mcp
npm install
npx playwright install chromium # one-time browser download
cp .env.example .env # then add YOUR Sell The Trend login (never commit it)Open .env and set:
STT_EMAIL=you@example.com
STT_PASSWORD=your-password
STT_HEADLESS=false # keep false, STT blocks headless loginsclaude mcp add sellthetrend -s user -- node /ABSOLUTE/PATH/TO/sellthetrend-mcp/server.mjsThen restart Claude Code so the tools load. Verify: claude mcp list → sellthetrend ✔ Connected.
STT guards login with a Cloudflare "verify you are human" check that only a human can pass. So:
In Claude, call stt_login (or just ask: "log into Sell The Trend").
A browser window opens (email + password pre-filled). Tick "verify you are human" → Sign in.
The session is held by the running server and reused for every tool call.
(Standalone alternative when the server isn't running: node login.mjs.)
"Research the catnip niche on Sell The Trend and give me a detailed PDF report." → drops a dossier in ./reports/.
"Find winning cat dental products with their cost, profit and saturation."
"Open the Facebook Ad finder and show me the top pet ads."
"Screenshot my NEXUS page."
Reports are saved to ./reports/winning-product-report-<keyword>-<timestamp>.pdf. Each has a summary table + per-product dossiers with embedded image, economics, AI insights, competitor stores (URLs + revenue), AliExpress suppliers, FB Ad Library link, and targeting.
.env)Var | Purpose |
| your login (pre-fills the form) |
|
|
| optional residential proxy to avoid IP rate-limits |
| optional overrides if STT changes its UI |
"verify you are human" loops / logged out → call stt_login again (session expired). Never kill -9 the browser. That discards the session.
Empty results → STT changed selectors; use stt_navigate + stt_snapshot to find the new path and set overrides in .env.
IP blocked → add a residential proxy via STT_PROXY_*.
server.mjs # the MCP server (14 tools)
report.mjs # parser + detailed PDF report engine
login.mjs # standalone one-time manual login
make_report.mjs # generate a report from sample data
smoke.mjs # lists the tools (sanity check)
reports/ # generated PDFs (gitignored)For personal research on your own account. Respect Sell The Trend's Terms of Service and robots policies. The author/operator is responsible for how it's used. MIT-licensed code; the data belongs to Sell The Trend and its sources.
Click an element by CSS selector or visible text.
Inputs: text, selector.
Run JavaScript in the page and return the JSON-serializable result. The escape hatch for anything the other tools don't cover.
Inputs: script (required).
Extract data from the current page via a CSS selector. Returns innerText (or a given attribute) of each match.
Inputs: selector (required), limit, attribute.
Fill an input by CSS selector; optionally submit with Enter.
Inputs: value (required), selector (required), submit.
Open Sell The Trend login in THIS server's browser window and wait (up to 5 min) for you to solve the human-check + sign in. Run once per server start if stt_status shows loggedIn:false. (Server must be headful: STT_HEADLESS=false.)
Inputs: no named parameters.
Search Sell The Trend NEXUS for a niche/keyword and return STRUCTURED product data (name, sell price, orders, sales). The reliable way to pull winning-product data.
Inputs: keyword (required).
Research a niche/keyword on NEXUS and generate a DETAILED PDF dossier under ./reports/: full product list + deep dossiers (cost, profit, saturation, stores+URLs, suppliers, Facebook ad library, targeting, image) for the top products. Use this by default whenever researching a product.
Inputs: keyword (required), deepCount, recommendation.
Persist the current browser session after a manual login so future runs stay logged in.
Inputs: no named parameters.
Take a PNG screenshot of the current page so you can see the dashboard.
Inputs: fullPage.
Search Sell The Trend product research for a niche/keyword and return found product cards. Best-effort — if cards are empty, use stt_navigate + stt_snapshot to find the real path/selector and set STT_SEARCH_PATH / STT_CARD_SELECTOR in .env.
Inputs: query (required).
Return a text snapshot of the CURRENT page (title, url, visible text, links, buttons).
Inputs: no named parameters.
Report Sell The Trend session/auth status and whether you're logged in.
Inputs: no named parameters.
Open Sell The Trend winning/handpicked products and return a snapshot. Tune STT_WINNING_PATH in .env if the default isn't right.
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 14 tools
Tools have mostly distinct purposes, but stt_research, stt_research_report, and stt_search_products overlap in searching products. Descriptions clarify differences (structured data vs. PDF vs. raw cards), so agents can differentiate.
All tools use the 'stt_' prefix with consistent verb_noun snake_case (e.g., stt_click, stt_extract, stt_research_report). No mixed conventions or ambiguous names.
14 tools is well-scoped for a platform automation server covering login, navigation, interaction, data extraction, research, and reporting. No excess or deficiency.
Covers major workflows: login, navigation, interaction, research, reporting. Minor gaps like logout or advanced filtering, but core user tasks are supported.
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
SEO MCP server for keyword research, live SERPs, backlinks, site audits and AI visibility.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Hosted MCP server for 3Dsellers, the multichannel selling platform. Connect Claude, ChatGPT, Cursor, VS Code or any MCP client and manage your eBay, Amazon, Walmart, Etsy, Shopify, WooCommerce and TikTok Shop stores in plain language: search and update products, publish listings, sync inventory, tag and track orders, run bulk actions and CSV imports, and reply to customer messages. 120+ tools. Sign in with OAuth or a personal token. No eBay developer account and nothing to install. Setup guides and config examples for every client: https://github.com/3dsellers/ebay-mcp-server
