艾尔莎MCP服务器

生产就绪的FastMCP服务器提供 艾尔郡API全面覆盖 和 75+MCP工具 API的15个类别。通过统一界面发布到13个以上的平台，包括Facebook、Instagram、Twitter/X、LinkedIn、TikTok、YouTube、Pinterest、Reddit、Snapchat、Telegram、Threads、Bluesky和Google Business Profile。

特性：多用户SaaS管理、AI内容生成、高级自动化、完整的媒体库、品牌管理和全面的验证工具。

特性

核心出版

多平台发布：同时发布到13+个社交网络
调度：以ISO 8601日期格式安排未来发布的帖子
批量操作：在一次操作中创建多个帖子
自动标签：自动生成标签（1-10个标签）
常青含量：自动转发永恒内容（1-10次转发）
第一条评论：自动对帖子进行首次评论
审批工作流：发布前提交帖子以供批准

参与管理

API评论：阅读、添加、回复和删除帖子中的评论
私信：发送DM、管理对话、标记为已读（商业计划书）
谷歌商业评论：获取评论、回复、管理评论回复

分析与洞察

后分析：参与度指标（点赞、分享、评论、印象）
社交分析：跨多个平台聚合分析
个人资料分析：关注者数量、人口统计数据和受众洞察
链接分析：跟踪缩短URL的性能

多用户和SaaS（商业计划）

简介API：完成SaaS平台的多用户配置文件管理
团队管理：使用基于电子邮件的访问创建团队配置文件
配置文件筛选：按连接的平台、标签和活动进行筛选
OAuth集成：用户管理的社交帐户链接

AI驱动功能（最大包）

内容生成：人工智能支持的带有音调控制的后期文本创建
标签生成：人工智能驱动的标签建议
图像标题：图像自动生成AI字幕

自动化与调度

自动调度API：人工智能驱动的最佳发布时间
常青含量：自动转发永恒内容（1-10次转发）
计划帖子日历：查看和管理内容日历
自动转发跟踪：跟踪经常性员额系列

内容发现与优化

标签发现：趋势和相关标签建议
性能分析：随时间跟踪标签指标
社交：检索特定于平台的内容提要
区域趋势：按地区发现热门内容

品牌管理

品牌简介：集中品牌标识管理
品牌资产：存储徽标、颜色和模板
品牌一致性：在各个帖子中应用品牌指南

高级功能

网络钩子：事后事件的实时通知（商业计划）
链接缩短：自定义URL缩短和分析（Max Pack）
广告管理：完成Facebook广告与目标定位的集成
媒体库：完整的媒体资产管理，90天存储
Unsplash集成：访问免版税图像

质量保证与验证

发布前验证：发布前验证帖子
媒体验证：检查媒体URL和格式兼容性
计划验证：验证日程时间和时区处理
错误预防：在问题到达社交平台之前抓住它们

基础设施

完整历史API：使用高级过滤功能跟踪所有帖子
用户管理：帐户设置和API使用限制
时区工具：列出时区并在时区之间转换
错误处理：全面的错误处理和验证

支持平台

平台	图片	视频	日程安排	备注
脸书✅	✅	✅	最多63206个字符
Instagram	✅	✅	✅	需要商业账户
推特/X✅	✅	✅	280个字符限制
领英✅	✅	✅	最多3000个字符
抖音❌	✅	✅	仅视频
油管❌	✅	✅	视频上传
Pinterest✅	✅	✅	-
Reddit✅	✅	✅	-
Snapchat	✅	✅	✅	-
电报	✅	✅	✅	-
线程	✅	✅	✅	500个字符限制
蓝调	✅	❌	✅	300个字符限制
谷歌商业简介	✅	✅	✅	前Google My Business

先决条件

Python 3.10或更高版本
艾尔郡API账户（免费版可用）
API密钥来自艾尔郡仪表板
通过艾尔郡连接的社交媒体账户

安装

选项1：使用紫外线（推荐）

# Clone or navigate to the project directory
cd ayrshare-mcp

# Create virtual environment
uv venv

# Activate virtual environment
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -e .

选项2：使用pip

# Clone or navigate to the project directory
cd ayrshare-mcp

# Create virtual environment
python -m venv .venv

# Activate virtual environment
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -e .

配置

复制环境模板:

   cp .env.example .env

获取艾尔郡API密钥:

- 注册地址： ayrshare.com - 导航至 API密钥页 - 复制API密钥

将API密钥添加到.env:

   AYRSHARE_API_KEY=your_actual_api_key_here

可选：添加配置文件密钥 （适用于多租户场景）：

   AYRSHARE_PROFILE_KEY=your_profile_key_here

连接社交媒体帐户:

- 首选艾尔郡仪表板 - 单击要使用的每个平台的“连接帐户” - 遵循OAuth流程对每个平台进行授权

用法

本地运行（STDIO模式）

用于Claude Desktop或其他MCP客户端：

fastmcp run src/server.py

或者直接使用Python：

python src/server.py

作为HTTP服务器运行

对于远程访问或API集成：

python src/server.py --http

服务器将于启动 http://localhost:8000 默认情况下。

测试服务器

您可以使用FastMCP的开发模式测试服务器：

fastmcp dev src/server.py

这将打开一个交互式界面来测试所有工具和资源。

可用工具

核心发布工具

1.post_to_social

立即将帖子发布到多个平台。

{
    "post_text": "Check out our new product launch! 🚀",
    "platforms": ["facebook", "twitter", "linkedin"],
    "media_urls": ["https://example.com/image.jpg"],
    "shorten_links": true
}

2.调度_发布

为未来的发布安排一个帖子（ISO 8601日期格式）。

{
    "post_text": "Happy New Year! 🎉",
    "platforms": ["facebook", "instagram"],
    "scheduled_date": "2025-01-01T00:00:00Z",
    "media_urls": ["https://example.com/celebration.jpg"]
}

3.删除_发布

从指定平台删除帖子。

{
    "post_id": "abc123",
    "platforms": ["facebook"]  # Optional: omit to delete from all
}

4.更新_帖子

更新现有已安排或已发布帖子的内容。

{
    "post_id": "abc123",
    "post_text": "Updated content",
    "platforms": ["facebook", "twitter"]
}

5.重试_发布

重试失败的帖子（在临时平台问题后有用）。

{
    "post_id": "abc123"
}

6.复印_邮寄

将现有帖子复制到不同的平台或重新安排。

{
    "post_id": "abc123",
    "platforms": ["linkedin", "pinterest"],
    "scheduled_date": "2024-12-26T15:00:00Z"  # Optional
}

高级发布工具

7.散装邮件

在一次操作中创建多个帖子。

{
    "posts": [
        {
            "post": "First post content",
            "platforms": ["facebook", "twitter"]
        },
        {
            "post": "Second post content",
            "platforms": ["linkedin"],
            "scheduleDate": "2024-12-25T12:00:00Z"
        }
    ]
}

8.带有自动标签的帖子

自动生成标签（1-10个标签）。

{
    "post_text": "Excited to announce our new sustainable product line!",
    "platforms": ["twitter", "instagram"],
    "max_hashtags": 3,
    "position": "auto"  # or "end"
}

9.创建_绿色_帖子

创建自动转发内容（1-10次转发，至少间隔2天）。

{
    "post_text": "The best time to start is now!",
    "platforms": ["facebook", "twitter"],
    "repeat": 5,
    "days_between": 7,
    "start_date": "2024-12-25T09:00:00Z"  # Optional
}

10.首次投稿

自动发表第一条评论（发表后20-90秒）。

{
    "post_text": "New blog post is live!",
    "platforms": ["facebook", "linkedin"],
    "first_comment": "Read more at our website: https://example.com/blog",
    "comment_media_urls": ["https://example.com/blog-preview.jpg"]
}

11.提交_邮寄_批准

发布前提交帖子以供审批。

{
    "post_text": "Big announcement coming soon!",
    "platforms": ["facebook", "twitter", "linkedin"],
    "notes": "Please review for compliance",
    "scheduled_date": "2024-12-25T10:00:00Z"
}

12.审批岗位

批准一个等待批准的职位。

{
    "post_id": "abc123"
}

分析工具

13.成本分析

获取特定职位的参与度指标。

{
    "post_id": "abc123",
    "platforms": ["facebook", "twitter"]
}

回报：点赞、分享、评论、印象、影响力、参与率。

14.社交分析

跨多个平台获取聚合分析。

{
    "platforms": ["facebook", "instagram", "twitter"]
}

15.get_profile_analytics

获取个人资料/账户分析，包括关注者数量和人口统计数据。

{
    "platforms": ["facebook", "linkedin"]  # Optional
}

API工具评论

16.get_post_comments

获取特定帖子的所有评论。

{
    "post_id": "abc123",
    "platforms": ["facebook", "instagram"]  # Optional
}

17.添加_通知_发布

向现有帖子添加评论。

{
    "post_id": "abc123",
    "comment_text": "Thanks for all the feedback!",
    "platforms": ["facebook", "linkedin"]
}

18.回复

对具体评论的回复。

{
    "comment_id": "comment_xyz",
    "reply_text": "Thank you for your support!",
    "platform": "facebook"
}

19.删除_发布_注释

从帖子中删除评论。

{
    "comment_id": "comment_xyz",
    "platforms": ["facebook"]
}

直接消息API工具（需要商业计划书）

20.send_direct_message

向用户发送直接消息。

{
    "platform": "facebook",
    "recipient_id": "user123",
    "message": "Thank you for reaching out!",
    "media_urls": ["https://example.com/response.jpg"]  # Optional
}

21.获取消息_对话

获取消息对话列表。

{
    "platform": "instagram",
    "limit": 50  # Optional
}

22.获取_对话_历史

从特定对话中获取消息。

{
    "conversation_id": "conv123",
    "platform": "facebook",
    "limit": 100  # Optional
}

23.标记_消息_阅读

将邮件标记为已读。

{
    "message_ids": ["msg1", "msg2", "msg3"],
    "platform": "instagram"
}

谷歌商业评论API工具

24.获取谷歌_业务_视图

获取Google Business Profile位置的评论。

{
    "location_id": "loc123"  # Optional: omit for all locations
}

25.回复_查看

回复Google Business Profile评论。

{
    "review_id": "review123",
    "response_text": "Thank you for your feedback!"
}

26.移除_查看_响应

删除评论回复。

{
    "review_id": "review123"
}

Webhooks API工具（需要商业计划书）

27.setup_webhook_endpoint

为发布事件创建webhook订阅。

{
    "url": "https://your-domain.com/webhook",
    "events": ["post.published", "post.failed", "post.scheduled"]
}

28.列表_webhook_订阅

获取所有已配置的webhooks。

{}

29.update_webhook_config配置

更新现有的webhook。

{
    "webhook_id": "webhook123",
    "url": "https://new-domain.com/webhook",  # Optional
    "events": ["post.published", "post.analytics"]  # Optional
}

30.拆卸挂钩

删除webhook订阅。

{
    "webhook_id": "webhook123"
}

链接API工具（需要Max Pack附加组件）

31.短网址

使用可选的自定义slug缩短URL。

{
    "url": "https://example.com/very/long/url/path",
    "custom_slug": "promo2024"  # Optional
}

32.get_link_analytics

获取缩短链接的分析。

{
    "link_id": "link123"
}

广告API工具（需要商业计划书）

33.创建_来源_帖子

从现有帖子创建付费广告活动。

{
    "post_id": "abc123",
    "budget": 50.00,
    "duration": 7,  # days
    "targeting": {  # Optional
        "age_range": "25-45",
        "interests": ["technology", "business"]
    }
}

34.获取_分析

获取广告活动的性能分析。

{
    "ad_id": "ad123"
}

35.管理_活动

更新广告预算或状态。

{
    "ad_id": "ad123",
    "budget": 75.00,  # Optional
    "status": "paused"  # Optional: active, paused
}

36.停止_活动

停止并删除广告活动。

{
    "ad_id": "ad123"
}

媒体管理工具

37.上传_媒体

将媒体上传到Ayrshare库以供重用。

{
    "file_url": "https://example.com/product-image.jpg",
    "file_name": "summer-collection-hero.jpg"  # Optional
}

38.validate_media_url

验证媒体URL的可访问性和格式。

{
    "media_url": "https://example.com/image.jpg"
}

39.get_unsplash_image

从Unsplash集成中获取免版税图像。

{
    "query": "sunset beach vacation",  # Search query
    # OR
    "image_id": "HubtZZb2fCM"  # Specific image ID
}

平台信息

40.列表平台

获取有关所有支持平台的信息。

{}

返回：平台功能、字符限制和要求。

______________________________________________________________________

多用户配置文件管理（商业计划）

41.创建用户文件

为多租户SaaS应用程序创建新的用户配置文件。

{
    "title": "Client ABC Social Account",
    "messaging_active": true,
    "team": false,
    "disable_social": ["snapchat", "tiktok"],
    "tags": ["client-abc", "premium-tier"]
}

42.列表_用户_文件

列出并过滤所有用户配置文件。

{
    "has_active_social_accounts": true,
    "includes_active_social_accounts": ["facebook", "instagram"],
    "action_log": true,
    "limit": 100
}

43.用户文件详细信息

获取特定配置文件的详细信息。

{
    "profile_key": "PROFILE_KEY_HERE"
}

44.update_user_profile

更新配置文件设置和配置。

{
    "profile_key": "PROFILE_KEY_HERE",
    "settings": {
        "messaging_active": false,
        "disable_social": ["reddit"]
    }
}

45.delete_user_profile

删除用户配置文件（不可逆）。

{
    "profile_key": "PROFILE_KEY_HERE"
}

______________________________________________________________________

历史和内容日历

46.get_post_by_history_id

获取特定历史帖子的详细信息。

{
    "history_id": "hist_abc123"
}

47.获取所有预定帖子

查看包含所有已安排帖子的内容日历。

{}

48.获取_发布_系列

追踪常青内容自动转发系列。

{
    "auto_repost_id": "repost_xyz789"
}

______________________________________________________________________

媒体库管理

49.列表_所有_媒体

按页码列出库中的所有媒体文件。

{
    "limit": 50,
    "cursor": "next_page_token"  # Optional
}

50.获取详细信息

获取特定媒体文件的详细信息。

{
    "media_id": "media_abc123"
}

51.delete_media_file

从库中删除媒体文件。

{
    "media_id": "media_abc123"
}

______________________________________________________________________

自动化和人工智能调度

52.设置_自动_时间表

配置人工智能驱动的最佳发布时间。

{
    "schedule_config": {
        "timezone": "America/New_York",
        "days": ["monday", "wednesday", "friday"],
        "times_per_day": 2
    }
}

53.get_current_auto_schedule

查看当前自动计划配置。

{}

54.修改自动时间表

更新自动计划设置。

{
    "schedule_config": {
        "times_per_day": 3
    }
}

55.删除_自动_计划

禁用自动日程安排。

{}

______________________________________________________________________

品牌管理

56.创建品牌文件配置

建立集中的品牌标识。

{
    "brand_data": {
        "name": "Company Name",
        "colors": ["#FF5733", "#C70039"],
        "logo_url": "https://example.com/logo.png",
        "tone": "professional"
    }
}

57.获取品牌文件资产

检索品牌资产和指导方针。

{}

58.更新_品牌_文件_设置

更新品牌配置。

{
    "brand_data": {
        "tone": "casual",
        "tagline": "Innovation at its best"
    }
}

______________________________________________________________________

社交订阅源检索

59.get_platform_feed

从特定平台获取内容提要。

{
    "platform": "instagram",
    "limit": 20
}

60.获取所有平台饲料

从所有连接的平台获取提要。

{
    "limit": 50
}

______________________________________________________________________

AI内容生成（最大包）

61.ai_generate_post_text

人工智能支持的帖子文本创建。

{
    "prompt": "Write about our new product launch",
    "platform": "linkedin",
    "tone": "professional"
}

62.ai_generate_hashtags_for_content

人工智能驱动的标签生成。

{
    "content": "Excited to announce our new sustainable product line!",
    "count": 5
}

63.ai_generate_image_caption

自动生成图像的AI字幕。

{
    "image_url": "https://example.com/product.jpg",
    "style": "engaging"
}

______________________________________________________________________

标签发现和分析

64.建议相关垃圾标签

为您的内容获取相关的标签建议。

{
    "content": "Check out our latest tech innovation",
    "platform": "twitter"
}

65.获取渲染平台标签

按平台和地区发现趋势标签。

{
    "platform": "instagram",
    "region": "US"
}

66.分析时间段

跟踪标签随时间的表现。

{
    "hashtag": "#TechInnovation",
    "time_range": "30days"
}

______________________________________________________________________

账户管理

67.获取计数信息

获取您的帐户详细信息和状态。

{}

68.更新计数设置

更新帐户首选项。

{
    "settings": {
        "email_notifications": true,
        "timezone": "America/Los_Angeles"
    }
}

69.获取上限

监控API使用情况和费率限制。

{}

______________________________________________________________________

实用函数

70.验证媒体可访问性

预先检查媒体URL的可访问性和格式。

{
    "url": "https://example.com/video.mp4"
}

71.可用时区列表

获取支持的时区列表以进行日程安排。

{}

72.转换时区

在时区之间转换时间。

{
    "time": "2024-12-25T10:00:00",
    "from_tz": "America/New_York",
    "to_tz": "Europe/London"
}

______________________________________________________________________

发布前验证

73.验证发布

发布前验证帖子参数。

{
    "post_data": {
        "post": "Hello world!",
        "platforms": ["facebook", "twitter"],
        "mediaUrls": ["https://example.com/image.jpg"]
    }
}

74.validate_media_for_platform

检查特定平台的媒体兼容性。

{
    "media_url": "https://example.com/video.mp4",
    "platform": "instagram"
}

75.validate_schedule_datetime

验证计划时间对平台有效。

{
    "schedule_date": "2024-12-25T10:00:00Z",
    "platform": "linkedin"
}

______________________________________________________________________

可用资源

MCP资源提供对自动更新的动态数据的基于URI的访问。这些对于监控、报告和实时数据访问特别有用。

1.ayrshare://history

访问最近的帖子历史记录（过去30天）。

退货：包含状态、平台和内容的帖子格式化列表。

用例：内容审核、合规性跟踪、绩效审查

2.ayrshare://platforms

访问已连接的社交媒体资料及其连接状态。

退货：包含帐户详细信息和状态的连接平台列表。

用例：帐户管理，解决连接问题

3.ayrshare://analytics/dashboard/{期间}

实时分析仪表板，包含所有平台的汇总指标。

URI模式:

ayrshare://analytics/dashboard/daily -过去24小时
ayrshare://analytics/dashboard/weekly -过去7天
ayrshare://analytics/dashboard/monthly -过去30天
ayrshare://analytics/dashboard/quarterly -过去90天

退货：综合仪表板，包括：

职位总数和成功率
平台故障
发布一致性指标
近期活动总结

用例：业绩监测、客户报告、战略规划

示例:

# Access monthly dashboard
dashboard = await mcp.read_resource("ayrshare://analytics/dashboard/monthly")

4.ayrshare://calendar/{年}/{月}

内容日历视图显示特定月份的所有计划帖子。

URI模式:

ayrshare://calendar/2024/12 -2024年12月
ayrshare://calendar/2025/01 -2025年1月

退货：日历视图，包括：

按日期分组的所有预定帖子
发布时间和平台
内容预览
每天总帖子数

用例：内容规划、日程可视化、活动协调

示例:

# View December 2024 calendar
calendar = await mcp.read_resource("ayrshare://calendar/2024/12")

5.ayrshare://profiles/overview

多租户SaaS管理的所有客户概况概述。

退货：综合简介摘要，包括：

活动和非活动配置文件总数
每个配置文件连接的平台
每位客户的平均平台数
个人资料详细信息

用例：客户管理、SaaS监控、账户健康跟踪

示例:

# Get all customer profiles
profiles = await mcp.read_resource("ayrshare://profiles/overview")

______________________________________________________________________

可用提示

MCP Prompts为常见的社交媒体任务提供模板化的LLM工作流程。这些有助于保持内容创建的一致性和质量。

1.创建社交帖子

使用适当的格式、标签和CTA生成平台优化的社交媒体内容。

参数:

topic （必填）：帖子的主要主题或主题
platform （必填）：目标平台（脸书、推特、领英、instagram、tiktok）
tone：期望的语气（专业、随意、有趣、鼓舞人心、有教育意义）-默认：“专业”
target_audience：目标受众描述-默认值：“一般”
call_to_action：可选CTA
include_hashtags：是否包含标签-默认值：true

支持平台:

推特：280个字符，1-2个标签，风格强烈
脸书：故事驱动，最少的标签，引人入胜的问题
领英：专业，3-5个标签，思想领导力
Instagram：视觉第一，10-30个标签，支持表情符号
试试看。：真实，3-5个热门标签，引人注目

退货：LLM生成准备发布内容的完整提示

示例用法:

# Generate LinkedIn post about AI
prompt = create_social_post(
    topic="The future of AI in business",
    platform="linkedin",
    tone="professional",
    target_audience="business executives",
    call_to_action="Read our full report",
    include_hashtags=True
)

2.分析性能

分析社交媒体绩效数据，并提供战略见解和建议。

参数:

post_analytics （必填）：JSON或包含分析数据的文本
time_period：涵盖的时间段-默认值：“最近30天”
platform：特定平台或“所有平台”-默认值：“所有平台

分析包括:

性能概述：关键指标、最佳/最差内容、基准
趋势与模式：内容类型、发布时间、平台有效性
观众洞察：参与模式、人口统计、主题共鸣
可采取行动的建议：具体的改进策略
接下来的步骤：具有预期影响的优先行动

退货：用于全面性能分析的结构化提示

示例用法:

# Analyze monthly performance
analytics_data = """
{
  "total_posts": 45,
  "engagement_rate": 3.2%,
  "reach": 125000,
  "top_platform": "linkedin"
}
"""

prompt = analyze_performance(
    post_analytics=analytics_data,
    time_period="last 30 days",
    platform="all platforms"
)

3.优化平台（现有）

考虑到角色限制和最佳实践，针对特定平台优化现有帖子内容。

4.生成标签（现有）

为帖子内容生成相关的、适合平台的标签。

5.调度活动（现有）

计划和安排跨平台的多帖子活动。

______________________________________________________________________

Claude桌面集成

添加到您的Claude Desktop配置(claude_desktop_config.json):

STDIO模式（推荐）

{
  "mcpServers": {
    "ayrshare": {
      "command": "python",
      "args": ["/absolute/path/to/ayrshare-mcp/src/server.py"],
      "env": {
        "AYRSHARE_API_KEY": "your_api_key_here"
      }
    }
  }
}

HTTP模式

{
  "mcpServers": {
    "ayrshare": {
      "url": "http://localhost:8000",
      "transport": "http"
    }
  }
}

示例

发布到多个平台

# Immediate post
result = await post_to_social(
    post_text="Excited to announce our new feature! Learn more at example.com",
    platforms=["facebook", "twitter", "linkedin"],
    media_urls=["https://cdn.example.com/feature-image.jpg"]
)

print(f"Posted with ID: {result['post_id']}")

安排未来职位

# Schedule for Christmas morning
result = await schedule_post(
    post_text="Merry Christmas from our team! 🎄",
    platforms=["facebook", "instagram", "twitter"],
    scheduled_date="2024-12-25T09:00:00Z",
    media_urls=["https://cdn.example.com/holiday.jpg"]
)

print(f"Scheduled for: {result['scheduled_for']}")

获取分析

# Check post performance
analytics = await get_post_analytics(
    post_id="abc123"
)

print(f"Analytics: {analytics['analytics']}")

查看帖子历史记录

# Access as resource
history = await mcp.get_resource("ayrshare://history")
print(history)

错误处理

服务器为常见问题提供详细的错误消息：

身份验证错误：API密钥无效或缺少凭据
验证错误：平台无效、日期格式错误、缺少必填字段
API错误：速率限制、平台特定错误、网络问题

所有工具返回a status 现场("success" 或 "error")以及a message 错误字段。

发展

项目结构

ayrshare-mcp/
├── src/
│   ├── server.py           # FastMCP server with tools and resources
│   └── ayrshare_client.py  # Async Ayrshare API client wrapper
├── pyproject.toml          # Project dependencies and metadata
├── .env.example            # Environment variable template
├── .gitignore              # Git ignore patterns
└── README.md               # This file

运行测试

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run with coverage
pytest --cov=src --cov-report=html

代码质量

# Format code
black src/

# Lint code
ruff check src/

安全最佳实践

永不承诺 .env 文件：API密钥应仅在中 .env （忽略）
使用环境变量：始终从环境中加载凭据
定期旋转API键：定期生成新密钥
监控使用情况：检查艾尔郡仪表板是否有异常活动
使用配置文件键：对于多租户场景，使用单独的配置文件密钥

故障排除

“无效的API密钥”错误

验证Ayrshare仪表板中的API密钥
检查钥匙是否正确设置 .env 文件
确保 .env 文件位于项目根目录中

“平台未连接”错误

首选艾尔郡仪表板
连接社交媒体帐户
验证连接状态是否显示“活动”

计划帖子未发布

检查计划日期是否在未来
验证时区（使用UTC或包含时区偏移）
确认平台支持调度

媒体上传失败

确保URL可公开访问
检查文件大小限制（因平台而异）
验证目标平台是否支持媒体格式

API费率限制

艾尔郡根据您的计划执行费率限制：

免费等级：每月5个职位
启动计划每月50个职位
专业计划每月500个职位
商业计划：自定义限制

监控您在艾尔郡仪表板.

资源

许可证

MIT许可证-有关详细信息，请参阅许可证文件

贡献

欢迎投稿！拜托：

分叉存储库
创建要素分支
进行更改
添加新功能的测试
提交拉取请求

支持

对于问题和疑问：

MCP服务器问题：在此存储库中打开一个问题
艾尔郡API问题：联系方式艾尔郡支持
一般问题：检查艾尔郡文件

Ayrshare MCP

快速接入

详细介绍

艾尔莎MCP服务器

特性

核心出版

参与管理

分析与洞察

多用户和SaaS（商业计划）

AI驱动功能（最大包）

自动化与调度

内容发现与优化

品牌管理

高级功能

质量保证与验证

基础设施

支持平台

先决条件

安装

选项1：使用紫外线（推荐）

选项2：使用pip

配置

用法

本地运行（STDIO模式）

作为HTTP服务器运行

测试服务器

可用工具

核心发布工具

1.post_to_social

2.调度_发布

3.删除_发布

4.更新_帖子

5.重试_发布

6.复印_邮寄

高级发布工具

7.散装邮件

8.带有自动标签的帖子

9.创建_绿色_帖子

10.首次投稿

11.提交_邮寄_批准

12.审批岗位

分析工具

13.成本分析

14.社交分析

15.get_profile_analytics

API工具评论

16.get_post_comments

17.添加_通知_发布

18.回复

19.删除_发布_注释

直接消息API工具（需要商业计划书）

20.send_direct_message

21.获取消息_对话

22.获取_对话_历史

23.标记_消息_阅读

谷歌商业评论API工具

24.获取谷歌_业务_视图

25.回复_查看

26.移除_查看_响应

Webhooks API工具（需要商业计划书）

27.setup_webhook_endpoint

28.列表_webhook_订阅

29.update_webhook_config配置

30.拆卸挂钩

链接API工具（需要Max Pack附加组件）

31.短网址

32.get_link_analytics

广告API工具（需要商业计划书）

33.创建_来源_帖子

34.获取_分析

35.管理_活动

36.停止_活动

媒体管理工具

37.上传_媒体

38.validate_media_url

39.get_unsplash_image

平台信息

40.列表平台

多用户配置文件管理（商业计划）

41.创建用户文件

3.优化平台（现有）

4.生成标签（现有）

5.调度活动（现有）