oneinterface/stormy-cookbook

本页由 AI 翻译，技术细节请以原文为准。查看原文

44 stars 1 forks 质量 67 趋势 16MIT

Stormy Social Data API 和 MCP 服务器（模型上下文协议）的开源食谱——一个 REST API 用于 TikTok、YouTube API、Instagram API、LinkedIn API、X（Twitter）API 和 Reddit......

概览

开源、可复制粘贴的和（模型上下文协议，可流式 HTTP）的配方。一个HTTP合约——搜索、个人资料、邮件、工作——跨越六个社交网络。没有代理池，没有六个供应商SDK，也没有需要看护的爬虫。将你的代理指向https://stormy.ai/mcp,，或者将REST base卷曲在https://stormy.ai/api/v1. 每个“获取社交数据”项目的起点都一样：六个不同的API、六种认证方案、六个速率限制、六种响应形状，还有一个周二会崩溃的抓取器。然后你在上面装一个大型语言模型，却发现这些都不是为代理设计的——没有成本信号，没有幂等性，没有持久作业，没有机器可读的能力列表。 Stormy就是那层已经建成的。这本食谱就是你怎么用它。 Stormy 在 https://stormy.ai/mcp 处使用可流式 HTTP 进行认证，并使用 HTTP 承载令牌进行认证。在 stormy.ai/account 获取密钥并导出：找到25个TikTok创作者在家用浓缩咖啡上发布内容，拉出他们的粉丝数，告诉我价格是多少。

概述（AI 翻译）

开源、可复制粘贴的Stormy Social Data API和Stormy MCP服务器（模型上下文协议，可流式HTTP）的配方。

一个HTTP合约——search、profile、emails、jobs]——跨越六个社交网络。没有代理池，没有六个供应商SDK，也没有需要看护的爬虫。你的代理指向https://stormy.ai/mcp，或者curl的REST base在https://stormy.ai/api/v1。

跳转到： 食谱 ·MCP快速入门 ·REST快速入门 ·端点 ·定价 ·错误 ·常见问题解答

为什么会有这样的存在

每个“获取社交数据”项目的起点都一样：六个不同的API、六种认证方案、六个速率限制、六种响应形状，还有一个周二会崩溃的抓取器。然后你在上面装一个大型语言模型，却发现这些都不是为代理设计的——没有成本信号，没有幂等性，没有持久作业，没有机器可读的能力列表。

Stormy就是那层已经建成的。这本食谱就是你怎么用它。

快速启动A：连接MCP服务器

Stormy MCP 服务器在 https://stormy.ai/mcp 使用可流式 HTTP 通信，并用 HTTP 承载令牌进行认证。在 stormy.ai/account 获取密钥并导出：

克劳德·科德

Codex CLI （'~/.codex/config.

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Stormy Cookbook — TikTok, YouTube, Instagram, LinkedIn, X and Reddit API recipes for AI agents

Open-source, copy-pasteable recipes for the Stormy Social Data API and the Stormy MCP server (Model Context Protocol, Streamable HTTP).

One HTTP contract — search, profile, emails, jobs — across six social networks. No proxy pool, no six vendor SDKs, no scraper to babysit. Point your agent at https://stormy.ai/mcp, or curl the REST base at https://stormy.ai/api/v1.

Jump to: Recipes · MCP quickstart · REST quickstart · Endpoints · Pricing · Errors · FAQ

Why this exists

Every “get social data” project starts the same way: six different APIs, six auth schemes, six rate limits, six response shapes, and a scraper that breaks on a Tuesday. Then you bolt an LLM on top and discover none of it is shaped for an agent — no cost signal, no idempotency, no durable jobs, no machine-readable capability list.

Stormy is that layer, already built. This cookbook is how you use it.

Quickstart A: connect the MCP server

The Stormy MCP server speaks Streamable HTTP at https://stormy.ai/mcp and authenticates with an HTTP bearer token. Get a key at stormy.ai/account and export it:

export STORMY_API_KEY="stm_live_..."   # never commit this

Claude Code

claude mcp add --transport http stormy https://stormy.ai/mcp \
  --header "Authorization: Bearer $STORMY_API_KEY"

Codex CLI (`~/.codex/config.toml`)

[mcp_servers.stormy]
url = "https://stormy.ai/mcp"
bearer_token_env_var = "STORMY_API_KEY"

Cursor / Windsurf / any `mcp.json` client

{
  "mcpServers": {
    "stormy": {
      "url": "https://stormy.ai/mcp",
      "headers": {

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "stormy": {
      "url": "https://stormy.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${STORMY_API_KEY}"
      }
    }
  }
}