渠道洞察服务
该MCP服务提供渠道分布和销售渠道分析，包括经销商网络、销售渠道、渠道覆盖等信息，帮助用户了解企业的渠道布局。
主要功能
- 🔍 企业关键词模糊搜索
- 🏪 渠道统计分析
- 📊 渠道企业搜索
- 🌍 同行业对比分析
- 📈 渠道效率分析
环境要求
- Python 3.10+
- 依赖包：python-dotenv, requests, mcp
本地快速启动
1. 克隆项目
git clone https://github.com/handaas/factory-channel-mcp-server
cd factory-channel-mcp-server
2. 创建虚拟环境&安装依赖
python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt
3. 环境配置
复制环境变量模板并配置：
cp .env.example .env
编辑 .env 文件，配置以下环境变量：
INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
4. streamable-http启动服务
python server/mcp_server.py streamable-http
服务将在 http://localhost:8000 启动。
支持启动方式 stdio 或 sse 或 streamable-http
5. Cursor / Cherry Studio MCP配置
{
"mcpServers": {
"handaas-mcp-server": {
"type": "streamableHttp",
"url": "http://127.0.0.1:8000/mcp"
}
}
}
STDIO版安装部署
设置Cursor / Cherry Studio MCP配置
{
"mcpServers": {
"factory-channel-mcp-server": {
"command": "uv",
"args": ["run", "mcp", "run", "{workdir}/server/mcp_server.py"],
"env": {
"PATH": "{workdir}/mcp_env/bin:$PATH",
"PYTHONPATH": "{workdir}/mcp_env",
"INTEGRATOR_ID": "your_integrator_id",
"SECRET_ID": "your_secret_id",
"SECRET_KEY": "your_secret_key"
}
}
}
}
使用官方Remote服务
1. 直接设置Cursor / Cherry Studio MCP配置
{
"mcpServers": {
"factory-channel-mcp-server":{
"type": "streamableHttp",
"url": "https://mcp.handaas.com/factory/channel_insight?token={token}"
}
}
}
注意：integrator_id、secret_id、secret_key及token需要登录 https://www.handaas.com/ 进行注册开通平台获取
可用工具
1. channel_insight_fuzzy_search
功能: 企业关键词模糊查询
根据提供的企业名称、人名、品牌、产品、岗位等关键词模糊查询相关企业列表。
参数:
matchKeyword(必需): 匹配关键词 - 查询各类信息包含匹配关键词的企业pageIndex(可选): 分页开始位置pageSize(可选): 分页结束位置 - 一页最多获取50条数据
返回值:
total: 总数resultList: 结果列表，包含企业基本信息
2. channel_insight_channel_analysis
功能: 渠道统计分析
对指定企业进行渠道统计分析，输出企业在同行业中的资金实力、品牌影响力、注册资本和销售实力等多方面的数据。
参数:
matchKeyword(必需): 匹配关键词 - 企业名称/注册号/统一社会信用代码/企业idkeywordType(可选): 主体类型枚举 - name/nameId/regNumber/socialCreditCode
返回值:
categoryCount: 同行总数financialStat: 资金实力分析regCapitalRank: 注册资本排名 - 显示注册资本超过同行的数量regCapitalScope: 所在注册资本范围data: 同行年营业额数据name: 数据范围ratio: 同行比例power: 同行数量
salesStat: 销量实力分析annualTurnoverRank: 年营业排名 - 显示营业额超过同行的数量annualTurnoverScope: 所在年营业额范围data: 同行年营业额数据categoryCount: 同行总数
productBrandList: 品牌占比name: 数据范围number: 数量ratio: 同行比例
productCategoryList: 品类占比name: 数据范围number: 数量ratio: 同行比例
3. channel_insight_channel_search
功能: 渠道企业搜索
根据工厂名称或产品名称以及指定的搜索条件，提供匹配的企业信息列表，包括企业基本信息及主营产品等。
参数:
matchKeyword(必需): 匹配关键词 - 工厂名称或产品名称（多个词用顿号隔开）keywordType(可选): 搜索类型 - 综合搜索/主营产品address(可选): 地区 - 格式：[["省份","市"],["省份","市"]]channelTradeType(可选): 销售模式 - 全部/外贸/内贸pageIndex(可选): 页码 - 从1开始pageSize(可选): 分页大小 - 一页最多获取50条数据
返回值:
total: 总数 - 最多返回10W家nameId: 企业idname: 企业名称foundTime: 成立日期mainProducts: 主营产品tagNames: 产品类目regCapital: 注册资本
使用场景
- 渠道优化: 企业优化销售渠道布局和管理，制定渠道发展策略
- 市场拓展: 分析市场空白区域，制定市场拓展和渠道扩张策略
- 竞争分析: 了解竞争对手的渠道优势和市场布局，制定竞争策略
- 合作伙伴选择: 寻找优质的经销商和渠道合作伙伴，建立合作关系
- 投资决策: 评估企业的渠道实力和市场覆盖能力，支持投资判断
- 行业研究: 研究特定行业的渠道分布和销售模式特点
- 供应链优化: 优化供应链布局，提高渠道效率和覆盖范围
使用注意事项
- 企业全称要求: 在调用需要企业全称的接口时，如果没有企业全称则先调取channel_insight_fuzzy_search接口获取企业全称
- 渠道数据: 渠道数据可能存在滞后性，建议结合实地调研和市场验证
- 市场变化: 渠道布局会随市场变化而调整，需关注数据的时效性
- 数据来源: 不同来源的渠道数据可能存在差异，建议交叉验证
- 地区格式: 地区搜索需按照指定格式输入，支持多地区组合查询
- 销售模式: 注意区分外贸和内贸的不同销售特点和渠道模式
使用提问示例
channel_insight_channel_analysis (渠道统计分析)
- 华为在手机行业的渠道实力如何？注册资本在同行中排第几？
- 小米的销售实力分析怎么样？年营业额在同行中的位置如何？
- 比亚迪的品牌影响力在新能源汽车行业中如何？品类占比情况怎样？
channel_insight_channel_search (渠道企业搜索)
- 搜索一下主营"手机配件"的渠道企业，主要分布在哪些地区？
- 找一下做外贸销售的企业有哪些？注册资本都是多少？
- 广东省有哪些做内贸的渠道商？产品类目都有什么？