跳到主要内容

社交媒体插件

社交媒体插件添加了从流行社交平台搜索和检索内容的支持。本页提供每个支持来源的详细文档。

安装​

pip install browse-mcp-plugin-social-media

支持的平台​

来源描述状态
githubGitHub 仓库和代码可用
twitterTwitter/X 帖子需要 API
zhihu知乎问答文章参考实现
xiaohongshu小红书帖子参考实现

:::note 实现状态 此插件是演示插件架构的参考实现。GitHub 搜索器使用公共 API。其他来源具有占位符实现，需要完成实际的 API 集成。 :::

GitHub​

搜索 GitHub 仓库、代码和问题。

配置​

变量必需描述
GITHUB_TOKEN可选个人访问令牌，用于更高的速率限制

没有令牌，GitHub 允许每小时 60 个请求。有令牌时，您可以获得每小时 5,000 个请求。

创建令牌：

  1. 前往 GitHub 设置 > 开发者设置 > 个人访问令牌
  2. 生成具有 repo 权限的新令牌
  3. 设置环境变量

使用​

# 搜索仓库
browse_search([
    {"searcher": "github", "query": "machine learning python", "max_results": 10}
])

# 使用特定过滤器搜索
browse_search([
    {"searcher": "github", "query": "language:python stars:>1000", "max_results": 5}
])

响应格式​

Platform: github
Post ID: owner/repo-name
Title: Repository Name
Author: owner
Content: Repository description...
Published: 2024-01-15 10:30:00
URL: https://github.com/owner/repo-name
Engagement: 1234 likes, 56 comments
Tags: python, machine-learning, deep-learning

GitHub 搜索语法​

GitHub 支持高级搜索语法：

查询描述
language:python按语言过滤
stars:>1000最低星数
forks:>100最低 fork 数
created:>2023-01-01创建日期之后
pushed:>2023-01-01最后推送日期之后
topic:machine-learning按主题过滤

示例：

browse_search([{
    "searcher": "github",
    "query": "transformer language:python stars:>500 topic:nlp",
    "max_results": 10
}])

Twitter/X​

搜索 Twitter 帖子和线程。

配置​

变量必需描述
TWITTER_BEARER_TOKEN是Twitter API v2 Bearer Token

获取令牌：

  1. 申请 Twitter 开发者账户
  2. 创建项目和应用
  3. 生成 Bearer Token

使用​

# 搜索推文
browse_search([
    {"searcher": "twitter", "query": "#MachineLearning", "max_results": 20}
])

# 使用运算符搜索
browse_search([
    {"searcher": "twitter", "query": "from:OpenAI GPT", "max_results": 10}
])

响应格式​

Platform: twitter
Post ID: 1234567890
Title: Tweet Preview...
Author: @username
Content: Full tweet content...
Published: 2024-01-15 10:30:00
URL: https://twitter.com/username/status/1234567890
Engagement: 500 likes, 100 comments, 50 shares
Tags: #MachineLearning, #AI

Twitter 搜索运算符​

运算符描述
from:username来自用户的推文
to:username回复用户
#hashtag包含标签
@mention提及用户
lang:en语言过滤
is:retweet包含转发
-is:retweet排除转发

知乎​

搜索知乎问题、回答和文章。

配置​

变量必需描述
ZHIHU_API_KEY可选API 密钥，用于更高的速率限制

使用​

# 搜索知乎内容
browse_search([
    {"searcher": "zhihu", "query": "机器学习", "max_results": 10}
])

# 搜索英文关键词
browse_search([
    {"searcher": "zhihu", "query": "machine learning", "max_results": 5}
])

响应格式​

Platform: zhihu
Post ID: 123456789
Title: 问题标题
Author: 作者名称
Content: 回答或文章内容...
Published: 2024-01-15 10:30:00
URL: https://www.zhihu.com/question/123456789
Engagement: 1000 likes, 50 comments
Tags: 机器学习, 人工智能

小红书​

搜索小红书笔记和帖子。

配置​

变量必需描述
XIAOHONGSHU_API_KEY可选访问 API 密钥

使用​

# 搜索小红书内容
browse_search([
    {"searcher": "xiaohongshu", "query": "数码产品测评", "max_results": 10}
])

响应格式​

Platform: xiaohongshu
Post ID: 123456789
Title: 帖子标题
Author: @username
Content: 帖子内容...
Published: 2024-01-15 10:30:00
URL: https://www.xiaohongshu.com/explore/123456789
Engagement: 500 likes, 30 comments
Tags: 数码, 测评, 好物推荐
Media: 3 attachment(s)

SocialPost 类型​

所有社交媒体来源返回 SocialPost 对象：

@dataclass
class SocialPost:
    # 核心字段
    post_id: str        # 唯一标识符
    title: str          # 帖子标题或预览
    content: str        # 主要内容
    author: str         # 作者名称/用户名
    platform: str       # 平台名称
    url: str            # 直接链接
    published_date: datetime

    # 互动指标
    likes: int = 0
    comments: int = 0
    shares: int = 0

    # 可选字段
    tags: List[str]
    media_urls: List[str]
    extra: Dict

启用/禁用来源​

控制哪些社交媒体来源处于活动状态：

# 只启用特定来源
export BROWSE_MCP_ENABLED_SOURCES="arxiv,github,twitter"

# 或禁用特定来源
export BROWSE_MCP_DISABLED_SOURCES="zhihu,xiaohongshu"

速率限制​

每个平台有不同的速率限制：

平台未认证已认证
GitHub60/小时5,000/小时
Twitter不适用因等级而异
知乎取决于实现取决于实现
小红书取决于实现取决于实现

插件内部处理速率限制。如果您遇到限制，请考虑：

  • 添加 API 密钥以获得更高的限制
  • 减少每个查询的 max_results
  • 在搜索之间添加延迟

贡献​

社交媒体插件是开源的。要贡献：

  1. Fork 仓库
  2. 实现或改进搜索器
  3. 添加测试
  4. 提交 pull request

优先领域：

  • 完成 Twitter API 集成
  • 添加知乎 API 集成
  • 添加小红书 API 集成
  • 添加新平台（LinkedIn、Reddit 等）

下一步​