Starlecta influencer tools

starlecta-examples

Starlecta 的开源示例。Starlecta 是面向土耳其品牌和代理机构的网红数据分析平台。Starlecta 追踪 Instagram 创作者及其合作品牌（Story、帖子和 Reels），并说明指标的定义和范围。

适用对象： 品牌和代理机构的开发者与分析师，他们想了解 Starlecta 的公开数据是如何整理的、通过代码读取这些数据，或通过 MCP 将其连接到 AI 助手。本仓库不是产品，也不包含任何客户数据；此处介绍的实时工具均为 Starlecta 的公开工具。

土耳其语： Starlecta 是面向土耳其品牌和代理机构的网红数据分析平台；它追踪 Instagram 内容创作者及其合作品牌（Story、帖子、Reels），并说明指标的定义和范围。本仓库介绍 starlecta.com 上实时提供的免费工具，以及通过 Agent 密钥托管的 MCP 服务（“实时工具”部分）；此外还包含基于公开示例数据的只读本地 MCP 服务、离线示例工作流和完全合成的示例输出。安全问题请联系：[email protected]。

starlecta.com 上的实时工具

除下方的离线示例外，Starlecta 还基于真实数据提供免费工具。本节中的所有内容均由 Starlecta 托管；本仓库中的代码仅调用这些工具。关于访问权限、限制和端点的权威信息，请参阅：starlecta.com/auth.md。更多信息：文档、页面索引 llms.txt、MCP 服务卡片。

免费网页工具（在浏览器中使用，无需注册）：

工具	URL
网红查询	starlecta.com/en/demo
比较两位网红	starlecta.com/en/demo/compare
搜索与 AI 搜索	starlecta.com/en/demo/search
趋势云（过去 7 天分享的标签、产品、平台和品牌）	starlecta.com/en/tools/trend-cloud
互动率计算器	starlecta.com/en/tools/engagement-rate-calculator
Story 浏览量估算器	starlecta.com/en/tools/story-views-estimator
活动内容规划器	starlecta.com/en/tools/campaign-content-planner

交互式演示供浏览器用户使用；请勿对其进行自动化操作。Agent 使用密钥（见下文）。实时工具根据 Starlecta 追踪的账号提供答案，并显示带日期的四舍五入数据；它们并非土耳其创作者的完整名单。

托管的 MCP 服务： https://starlecta.com/mcp（Streamable HTTP，无状态）。工具：lookup_influencer、compare_influencers、search_influencers、ai_search_influencers、trend_cloud。trend_cloud 无需密钥即可使用。发现卡片：server-card.json。客户端配置（Cursor、VS Code、Claude Desktop、Claude Code）：live/mcp-configs。

获取密钥（Agent 可自行操作，一次即可）：

curl -X POST https://starlecta.com/api/agent/keys   -H 'content-type: application/json'   -d '{"label":"<agent or company name, up to 80 characters>","email":"<contact e-mail>","use":"<what the agent will do, up to 200 characters>"}'

密钥以 slk_ 开头，且只会显示一次；Starlecta 仅保存其哈希值。每个地址每天可申请的密钥数量有限，因此请申请一个并重复使用。用户也可以填写表单（English、Türkçe）。请妥善保管密钥：切勿将其放在网页、公开仓库或共享提示词中。在 MCP 服务和 REST 端点上，使用 Authorization: Bearer slk_... 传递密钥。请仅将密钥用于申请时声明的用途；不得分享或转售密钥、复制目录、批量构建名单，或通过使用多个密钥绕过限制。如需撤销密钥，请联系 [email protected]。 REST 端点（均需携带 bearer 标头；OpenAPI：public-pages.json）：

• 查询：GET https://starlecta.com/api/agent/tools/lookup?handle=<instagram handle>
• 比较：GET https://starlecta.com/api/agent/tools/compare?a=<handle>&b=<handle>
• 搜索：GET https://starlecta.com/api/agent/tools/search?category=<code>&tier=<nano|micro|macro|mega>&followers_min=<n>&followers_max=<n>&er_measured=<true|false>（每个筛选条件都是可选的）
• AI 搜索：使用 {"sentence": "<one sentence, 2 to 200 characters>"} 调用 POST https://starlecta.com/api/agent/tools/ai-search。该句子会被解析为与搜索相同的筛选条件（仅快速模式）。

**答案包含的内容：**每个 handle 的状态为 open（公开的粉丝数和测量得出的互动率，附日期）、tracked（名称、等级、类别和四舍五入后的粉丝数范围，不含指标）或 not_listed（未匹配，或无法展示的账号）。搜索会返回数量（少于 10 个时显示为 fewer than 10）、最多两张公开资料卡，以及锁定结果的数量；绝不会列出已跟踪或锁定账号的身份信息。针对具名创作者，这些工具不包含 Starlecta Quality Score。引用数据时，请同时注明日期。

每个密钥的限额（上线时的限额；发放密钥的响应会列出你的限额）：

每日	lookup 30、compare 15、search 30、AI search 10
每分钟	所有工具合计 6 次请求
共享	所有 Agent 密钥还共同受每日总量限制；该限制独立于网站访客限额

429 携带 Retry-After 表示已达到限额：等待相应秒数。401 携带 {"error":"invalid_key"} 表示密钥缺失、错误或已撤销。404 表示该工具已关闭。MCP 服务对缺失或错误的密钥采用不同的报告方式：返回 HTTP 200，并包含 isError: true 和一个文本块，而不是 401。

尝试从命令行运行（live/agent-tools.mjs，Node 24，无依赖；从 STARLECTA_AGENT_KEY 读取密钥，等待一次 Retry-After 后停止）：

node live/agent-tools.mjs trend-cloud                  # no key needed
export STARLECTA_AGENT_KEY=slk_YOUR_KEY
node live/agent-tools.mjs lookup <handle>
node live/agent-tools.mjs compare <handle-a> <handle-b>
node live/agent-tools.mjs search --tier micro --category beauty --er-measured
node live/agent-tools.mjs ai-search "Turkish beauty creators with 10K to 100K followers"

trend-cloud 的输出示例（真实摘录，计算时间为 2026-10-30T19:17Z；数量每日变化）：

Trend Cloud, last_7_days, computed 2026-10-30T19:17:01.331943Z
Hashtags:
  #29ekimcumhuriyetbayramı  2657 posts
  #29ekim  2126 posts
Platforms:
  Trendyol  65625 shares
  Hepsiburada  60511 shares

包含示例答案的完整演示（AI 搜索、两次查询、一次比较和一则候选名单说明）：live/WALKTHROUGH.md。条款：terms、隐私。

离线示例：你可以用它们做什么

需求	此仓库中的示例	starlecta.com 上的指南
比较两位创作者但不判定胜负，并了解比较何时无效	workflows/compare-two-creators.mjs	比较两位创作者
仅根据汇总数据，向客户介绍竞争品牌的创作者活动	workflows/competitor-brief.mjs	代理机构行业与竞争对手简报
让 AI 助手读取少量公开样本池和互动基准	mcp-server/（只读 MCP 服务）	文档
了解每个字段及 null 的含义	DATA-DICTIONARY.md	方法

starlecta.com 上还有：跟踪竞争对手的 Instagram Stories、样例报告、土耳其。

试用

Node 24。工作流没有依赖，也不需要联网。

node workflows/compare-two-creators.mjs fixtures/compare-same-tier.json

# Comparison note: example-creator-a and example-creator-b
...
| Quality score (SQS) | 74 (coverage 92%, confidence high) | 66 (coverage 78%, confidence high) |
| Engagement rate, 90 days | 3.1% (38 posts and reels, as of 2026-10-21) | 2.9% (25 posts and reels, as of 2026-10-21) |

## How they stand

- Quality score: example-creator-a is higher than example-creator-b ("similar" means within 5 points).
- Engagement rate: example-creator-a is similar to example-creator-b ("similar" means within 15% of the higher rate).

当某个账号未被跟踪时，说明会如实注明，而不会编造数字（fixtures/compare-one-not-tracked.json）：

- Quality score: not comparable (one account is not tracked).
- Engagement rate: not comparable (one account is not tracked).

node workflows/competitor-brief.mjs fixtures/brief-input.json

# Competitor brief: Brand A and 3 tracked brands

Instagram, 2026-09-14 to 2026-10-13 (30 days). Synthetic example data.

| Brand | Verified posts | Left out (no evidence) | Creators | Returning | New |
| --- | --- | --- | --- | --- | --- |
| Brand A | 31 | 64 | 19 | 7 | 12 |
...
Brand A ranks 2 of 4 by verified posts and 2 of 4 by creators.

完整输出位于 expected/。运行 npm test 执行测试；有意更改后，运行 npm run golden 重写 expected/。

本地 MCP 服务（合成版）

cd mcp-server
npm ci
npm test
MCP_ALLOW_SYNTHETIC=1 MCP_DATA_SOURCE=test/fixtures/edition-from-export npm run stdio

该服务通过 stdio（或使用 npm start 的无状态 HTTP）提供 MCP。它提供四个只读工具：search_creator_examples、get_creator_example、compare_creator_examples、get_instagram_benchmark。在随附的合成版中，调用 get_creator_example 并传入 sentetik-guzellik-a 会返回：

Sentetik Güzellik A (sentetik-guzellik-a) · Beauty · Micro · 10K–100K · ~48000 followers
Engagement 3.1234; quality score (SQS): in the customer panel

传入未知名称则会返回 Not found. 和 Missing: not_in_open_pool，绝不会编造数据行。客户端配置（Claude Code、Claude Desktop、MCP Inspector）：mcp-server/examples/client-configs.md。详情见：mcp-server/README.md。

内容

路径	内容
DATA-DICTIONARY.md	示例文件中的每个字段、其单位以及 null 的含义
fixtures/benchmark-instagram-engagement.json	基准响应：按粉丝数层级和类别划分的互动率，仅含汇总数据
fixtures/compare-*.json	三个比较响应：同一层级、不同群组，以及一个未追踪的账号
fixtures/brief-input.json	品牌级汇总数据，采用简报工作流的示例格式（不是 API 响应）
workflows/	两个离线工作流
expected/	工作流根据夹具生成的说明
live/	实时工具辅助程序：agent-tools.mjs（命令行客户端）、mcp-configs/（适用于托管服务的 Cursor、VS Code、Claude Desktop 和 Claude Code 配置）以及 WALKTHROUGH.md
mcp-server/	只读本地 MCP 服务（stdio 和无状态 HTTP），包含独立的 package.json、固定版本的 SDK、合成版夹具和测试

数据与限制

• 此仓库中的夹具、预期输出和随附的 MCP 版本均为合成数据。唯一真实且带日期的摘录是实时工具部分及 live/WALKTHROUGH.md 中的 Trend Cloud 示例，采集自托管服务，日期为 2026-10-30；live/ 中的所有其他示例回答均标注为说明性内容。工作流夹具使用 example-creator-a 这类用户名；Instagram 不允许用户名中包含连字符，因此这些都不是真实账号。MCP 版本夹具使用 synthetic_beauty_a 这类名称和 sentetik-guzellik-a 这类标识。这些名称均为虚构，并标明了合成数据，但带下划线的用户名格式在 Instagram 上有效，因此也可能确实存在；请勿将其理解为对任何账号的描述。
• mcp-server/ 中的本地 MCP 服务提供选定范围内的公开示例（随附版本中有 10 个），并非土耳其的所有创作者。它没有默认数据源：你需要指定一个公共数据文件夹或 URL，而开放版文件不会公开发布。如需实时数据，请使用上文的托管工具；这些工具会根据 Starlecta 追踪的账号作答，并受其中所述限制约束。
• 工作流遵循以下规则：比较时使用响应中的区间，绝不指定赢家；比率和评分保留其日期、覆盖范围和缺失数据原因，绝不将 null 显示为零；实测 Reel 播放量与预估 Story 浏览量分开处理，绝不相加；共同创作者数量指为两个品牌发布过内容的账号数，而非共享受众数量。
• 质量评分不保证销量或覆盖范围。此处未公开 SQS 公式及权重；MCP 服务绝不会返回指定创作者的评分，而上方工作流输出中的 SQS 值是为占位用户名 example-creator-a 和 example-creator-b 编造的夹具数字。定义：SQS、互动率、Story 预估值。

许可与安全

代码：MIT，详见 LICENSE。许可仅涵盖代码；Starlecta 数据的再利用条款另行规定，详见 DATA-TERMS.md（草案）。如需报告安全问题，请联系 [email protected]，详见 SECURITY.md。