facebook-mcp 是一个托管式 Model Context Protocol (MCP) 服务器，为 Claude、Cursor、Windsurf 等 MCP 客户端提供只读的 Facebook 工具。它通过 handle 查询公开主页或个人资料，返回结构化 JSON 数据，包括精确的点赞数、联系方式、所有者信息，以及包含反应、评论和分享的帖子流。无需 Meta 开发者应用，也无需自行托管。
主要能力
- 查询公开 Facebook 主页或个人资料，返回主页记录（点赞数、联系方式、所有者等）和帖子流（含反应、评论、分享）。
- 支持通过 handle（用户名或数字 ID）查询。
- 返回结构化 JSON，便于 AI 客户端推理。
- 提供分页机制，通过 nextPageToken 遍历帖子流，每次返回 3 条帖子。
- 支持语言参数，影响字符串的本地化显示（如 followersCount 的文本格式）。
- 提供一个资源 URI（hasdata://facebook/language），列出 language 参数的可接受值，读取不消耗积分。
使用方式
- 获取 HasData API 密钥：在 HasData 仪表板免费创建，无需信用卡。
- 配置 MCP 客户端：
- 远程服务器 URL：https://mcp.hasdata.com/mcp?apis=facebook
- 使用 x-api-key 请求头传递密钥。
- 支持 OAuth 的客户端可直接添加为连接器并登录。
- 仅支持 stdio 的客户端可通过 npm 包 @hasdata/facebook-mcp 或 PyPI 包 hasdata-facebook-mcp 作为启动器连接。
- 调用工具：使用 hasdata_facebook_profile_getFacebookProfile 工具，传入 handle 参数。
- 分页：首次调用返回 profile、posts（最新一条）、photos 和 pagination（含 nextPageToken）。后续调用使用 nextPageToken 获取更多帖子，每次返回 3 条，直到响应中不再包含 token。
适用场景
- 查询品牌主页的点赞数、关注者数、讨论数等指标。
- 获取主页联系方式和确认所有者。
- 分析帖子流，找出分享最多的帖子。
- 比较品牌与竞争对手的反应组合。
- 检查主页是否验证及分类。
- 遍历帖子流，筛选特定类型（如视频）的帖子。
限制
- 仅支持公开主页和公开个人资料，私密个人账户和群组不支持。
- 不存在的、已删除的或非公开的主页仍返回 200 状态码，但响应中包含 error 而非 profile，且调用会计费。
- 首次调用帖子流只返回 1 条帖子，而非 postsPerPage 声明的 3 条。
- 后续分页调用不再返回 profile 和 photos。
- 联系方式是页面展示给请求者的信息，并非权威记录。
- 图片 URL 为 Facebook CDN 链接，带签名参数，会过期，需及时获取并存储文件。
- 计费：每次成功调用消耗 10 积分，响应大小不影响价格。免费层每月 1,000 积分（约 100 次调用），付费计划起价 $59/月（200,000 积分，约 20,000 次调用）。并发限制：免费层 1 请求/次，Startup 5，Basic 15，Growth 50-500。非 200 响应不计费，但成功调用未找到页面仍计费。
- 与 Meta 无关联，仅使用公开数据，用户需自行遵守 Meta 条款和适用法律。
其他信息
- 开源协议：MIT。
- 测试套件验证工具契约，每周运行一次。
- 可与其他 HasData API 共用密钥，通过 apis 参数组合使用。
