ai-market-research

ai-market-research Market Research Assistant

Quick Start

More Skills

Overview

The Market Research Assistant is used to answer "Is there an opportunity in this market," conduct research analysis, verify sources, and summarize evidence. It is suitable for marketing, operations, software, and education and training to call after clarifying business goals, content materials, or analysis targets. It combines inputs such as research questions or material excerpts, questions to be verified, candidate sources, webpage excerpts, literature clues, or comparative viewpoints, organizes the key context, and outputs research summaries, comparative insights, and decision recommendations for further execution, review, or delivery.

When to Use

Applicable Scenarios

• The user asks questions such as "Is there an opportunity in this market" and needs to quickly break down goals, identify priorities, and form executable results.
• Marketing, operations, software, and education and training need to generate research summaries, comparative insights, and decision recommendations around the Market Research Assistant.
• The user has already prepared the research goal (explain the question to be answered, comparison dimensions, judgment criteria, or delivery purpose.), research audience (explain the readers, roles, markets, courses, or usage scenarios the research conclusions should serve.), public webpage links (fill in publicly accessible webpages, reports, or material links; for restricted content, upload files or paste excerpts instead.), and wants to organize them into executable analysis or optimization results.
• The user needs to turn Market Research Assistant-related materials into clear conclusions, priorities, and next actions.

How to Call

Call the AI Skills API directly through the exported Python runner:

Command Example

Basic Call

python3 scripts/run.py --params '{}'

Call with Common Parameters

python3 scripts/run.py --params '{"goal":"研究目标"}'

Parameter Description

Parameter	Type	Required	Default	Description
goal	string	No	-	Explain the question to be answered, comparison dimensions, judgment criteria, or delivery purpose.
audience	string	No	-	Explain the readers, roles, markets, courses, or usage scenarios the research conclusions should serve.
materialUrl	string	No	-	Fill in publicly accessible webpages, reports, or material links; for restricted content, upload files or paste excerpts instead; a complete accessible URL is required.
materialFile	string	No	-	Upload research materials, webpage excerpts, literature notes, tables, or reports. Suitable when the materials are long or the original text needs to be preserved.
materialText	string	No	-	Paste the questions to be verified, candidate sources, webpage excerpts, literature clues, or comparative viewpoints.
brandRequirements	string	No	-	Supplement the source scope, time range, credibility requirements, prohibited sources, conclusion risks, or key points for manual review.

See the complete machine-readable parameter structure in references/form-schema.json。

Parameter Value Reference

This skill currently has no categorical parameters that require additional lookup.

Supported Input Formats

This skill currently accepts JSON parameters directly; if the parameters include link fields, pass complete, accessible URLs.

Example Request

The example parameters below can be passed directly to scripts/run.py, the runner will send them to the AI Skills API.

python3 scripts/run.py --params '{"goal":"研究目标"}'

Equivalent --params JSON：

{
  "goal": "研究目标"
}

Example return result

{
  "success": true,
  "data": {
    "message": "示例结果请以技能真实返回结构为准。"
  },
  "meta": {
    "executionTime": 842,
    "cached": false
  }
}

Deliverables

• Research summary, comparative insights, decision recommendations: organize the core results around the user's goals that can be directly read, reviewed, or delivered.
• Interpretation of input materials: combined with the research objective (explain the questions to be answered in this session, comparison dimensions, judgment criteria, or delivery purpose.), research audience (explain the readers, roles, markets, courses, or usage scenarios that the research conclusions will serve.), public web links (fill in publicly accessible web pages, reports, or material links; for restricted content, please upload files or paste excerpts instead.) to extract key context and the basis for judgment.
• Next actions: provide priorities, execution suggestions, or a content framework that can be further processed.

Suggestions for using the results

• First determine whether the output answers the user's core questions about the "Market Research Assistant".
• Then check whether the results cover the research summary, comparative insights, and decision recommendations, and whether clear next actions are provided.
• If there is little input material, it is recommended to have the user supplement the goals, audience, constraints, or source materials before running.

Preparation before running

• AISKILLS_BASE_URL: default https://ai-skills.ai
• AISKILLS_API_KEY: required, used for authenticated calls
• AISKILLS_TENANT_ID: default default