tec-do-guide

---
name: tec-do-guide
description: Guide WorkBuddy on when and how to use the Tec-Do MCP tools and local Skill blueprints for ad benchmarks, TikTok ad research, competitor analysis, and VOC sentiment analysis for global advertising and growth teams.
description_zh: 指导 WorkBuddy 何时以及如何使用 Tec-Do MCP 的工具和本地 Skill 蓝图，为出海广告投放和增长团队完成广告基准查询、TikTok 广告研究、竞品分析和用户口碑分析。
description_en: Guide WorkBuddy on when and how to use the Tec-Do MCP tools and local Skill blueprints for ad benchmarks, TikTok ad research, competitor analysis, and VOC sentiment analysis for global advertising and growth teams.
version: "1.0.0"
author: "tec-do"
---

This Connector exposes four Tec-Do 2.0 Ad & Growth Intelligence capabilities: two remote MCP tools and two local Skill blueprints.

## How to use
1. After the MCP is connected and a user sends a message, inspect the Connector
   capabilities before answering from general knowledge. In WorkBuddy this means
   using the MCP tool catalog exposed by `tools/list`.
2. Call `tools/list` to discover the current four tools.
3. For either remote MCP tool, call it directly with `tools/call`.
4. For either local Skill, call `tools/call` to get its blueprint: name,
   description, workflow, constraints, and reference URIs.
5. Call `resources/read` for each referenced file you need.
6. Execute blueprint-only Skills yourself following the returned instructions;
   the Server does not run Skill scripts or produce output files.

## Current Tool Catalog
- `get_ad_benchmark` — Remote MCP tool for CPM, CTR, CPC, and other ad benchmark data by country, platform, and industry.
- `ttcc_search_top_ads` — Remote MCP tool for TikTok top-ad search and performance data such as impressions, click-through-rate rank, and completion rate.
- `competitor-analysis-report` — Local Skill for structured competitor analysis, including feature comparison, pricing analysis, SWOT, and strategy recommendations.
- `voc-sentiment-analysis` — Local Skill for voice-of-customer (VOC) and sentiment analysis from forums and review sites.

## Remote MCP Interface Reference

### `get_ad_benchmark`

Route: `/mcp/benchmark`

Retrieves advertising benchmark data across countries/regions, platforms, and industries, including CPM, CTR, and CPC. Use it for advertising-cost estimation, ROI calculations, product selection, competitor analysis, market research, and trend analysis.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | Yes | A natural-language query. Include country/region, platform, industry/category, and desired metrics where possible. Returns aggregated data if no metric is specified. |

Examples:

- `Get CPM benchmarks for the gaming industry on Facebook in the United States`
- `Get CTR and CPC data for ecommerce on Google in China`
- `Get advertising benchmarks for casual games on TikTok`

Returns advertising benchmark data for cost estimation and ROI calculations.

### `ttcc_search_top_ads`

Route: `/mcp/ttcc_agent`

Searches TikTok Creative Center top ads and returns ad titles, brands, video details, impressions, click-through-rate rankings, completion-rate rankings, and other performance data. Use it for creative research, competitor ad-strategy analysis, inspiration, and market-trend research.

| Parameter | Type | Required | Default / Description |
|---|---|---|---|
| `keyword` | string | Yes | Search keyword. English keywords are recommended. |
| `country_code` | string | No | Comma-separated country codes. Default: `SG,US`. |
| `order_by` | string | No | Default: `impression`. Options: `for_you`, `impression`, `like`, `ctr`, `play_2s_rate`, `play_6s_rate`, `cvr`. |
| `period` | integer | No | Default: `30`. Options: `7`, `30`, or `180` days. Other values are rounded up to the nearest supported period. |
| `limit` | integer | No | Default: `15`; maximum: `50`. |

Returns a list of top ads. Each item can include `id`, `ad_title`, `brand_name`, `video_info`, `like`, `cost`, `cost_readable`, and `analytics`.

High-performing-ad guidance:

- `ctr_ranking` is a percentile ranking, not an actual click-through rate. Lower is better; `≤ 0.10` represents the top 10%.
- `cost_readable: "High Budget"` usually indicates substantial budget investment and can be a useful signal of a validated creative.
- Evaluate both `ctr_ranking` and `cost_readable`; do not rely on either metric alone.

## Notes
- In WorkBuddy, these tools are displayed with the Connector prefix (for example, `mcp__tec-do__get_ad_benchmark`).
- `tools/list` remains the source of truth for availability.