Inputs
Inputs used by VOC Insight MCP.
Before You Start
Using VOC Insight MCP is simple — just tell the AI what you want to analyze in natural language.
You don’t need to provide every parameter at once. Just give a brand name (plus competitors to compare, if any), and VOC Insight MCP will automatically identify the industry, recommend keywords, and confirm the analysis scope and related parameters with you before it starts collecting data.
Example
💡 Tip: If you’re not sure what to fill in, just provide the brand name. VOC Insight MCP will automatically identify the industry, recommend keywords, and confirm the analysis scope and related parameters with you before collection starts.
Cost Tips
Platform count, keyword count, and page count all affect the points consumed during data collection. For a quick validation of results, reduce the number of platforms, keywords, or pages; for more comprehensive consumer insight, use the default configuration.
Common Inputs
| Input | Notes | Default |
|---|---|---|
| Industry | Each report analyzes one industry only. If unspecified, the system identifies the industry from the brand and confirms it with you before collection. | 1 |
| Brands | Supports 1–4 brands, typically 1 primary brand + up to 3 competitors, all within the same industry. | 1 brand |
| Keywords | Supports 1–100 keywords to collect relevant discussions. If none are provided, the AI recommends keywords for your confirmation. | 12 keywords |
| Platforms | VOC Insight MCP covers only supported public social and review platforms outside mainland China1. China-based social media platforms are not supported. Xiaohongshu, Weibo, LinkedIn, and any platform not listed above are outside the supported scope. | Default platforms: Tiktok, Instagram, Youtube, X, Facebook, Pinterest, Trustpilot Optional platforms: Threads, Reddit |
| Pages per keyword | Number of result pages collected per platform per keyword. More pages increase coverage and the amount of data collected. | 10 pages |
Persona Inputs
Persona tools use the completed brand report and do not require collection platforms or keywords again.
| Tool | Required / key inputs | Rules |
|---|---|---|
get_persona_voc | brandId | Optionally keep the current reportId; read availableSections first |
get_persona_section | brandId, section | section must come from availableSections; echo nextCursor verbatim while paging; persona-detail also requires personaId, and competitor-report requires competitorBrand |
generate_persona_voc | brandId | Optional lang, windowDays (7–60, default 30), withCollection, and deferToCollection; generation is async and costs 99 credits |
get_persona_generation_progress / list_persona_questions | brandId | Free progress or starter-question lookup |
ask_persona | brandId, message, history | message is 1–1000 characters and history has up to 20 items; omit personaId for analyst mode, or provide it for first-person simulation |
ask_all_personas | brandId, message | Broadcasts one question; billed per request, not per persona |
get_persona_interview_summary | brandId, personaId, history | Only for first-person interviews; history must contain at least 2 assistant replies |
After generation completes, read the overview with get_persona_voc, then drill into only the sections you need. ask_persona, ask_all_personas, and interview summaries are simulated content, not real user testimony.
On REPORT_SUPERSEDED or CURSOR_STALE, discard the old reportId/cursor and reread the overview; do not continue with the stale cursor.
Input Principles
| Principle | Notes |
|---|---|
| Prefer official English names | Use the official English brand or product name when available to reduce mismatches |
| Keywords must be English | CJK keywords may be dropped by upstream search logic; translate Chinese topics into English first |
| Reuse before creating | If a relevant knowledge space already exists, refresh it instead of creating a duplicate |
| Choose page count by question | More pages increase coverage, collection time, and point cost |
| Confirm before creating | Before creating a knowledge space or starting collection, confirm industry, platforms, keywords, pages, estimated points, and estimated time |
Notes
1 This social analysis service is intended only for compliant public social-media and review-data analysis for global brands in markets outside mainland China, for the purpose of supporting global brand and product growth research. Customers are responsible for ensuring their use complies with applicable laws, regulations, and platform rules. Pangolinfo provides only the necessary data access and analysis capabilities and is not responsible for third-party data content or the results of reports generated from such data.