Skip to main content
Glama
kingcos

fanfou-mcp

by kingcos

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FANFOU_API_KEYYesYour Fanfou API key
FANFOU_PASSWORDNoYour Fanfou password
FANFOU_USERNAMENoYour Fanfou username
FANFOU_API_SECRETYesYour Fanfou API secret
FANFOU_OAUTH_TOKENNoYour Fanfou OAuth token
FANFOU_OAUTH_TOKEN_SECRETNoYour Fanfou OAuth token secret

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
generate_oauth_tokenA

生成 OAuth Token

使用用户名密码通过 x_auth 方式生成 OAuth Token,用于后续免密登录。 生成的 Token 会在控制台输出,用户需要手动保存到环境变量中。

环境变量要求:

  • FANFOU_API_KEY: 饭否应用的 API Key

  • FANFOU_API_SECRET: 饭否应用的 API Secret

  • FANFOU_USERNAME: 饭否用户名

  • FANFOU_PASSWORD: 饭否密码

Returns: 包含 OAuth Token 信息的字典,包括 oauth_token 和 oauth_token_secret

get_user_timelineA

根据用户 ID 获取某个用户发表内容的时间线

调用饭否 API 的 /statuses/user_timeline.json 接口获取指定用户的时间线。 如果 user_id 为空,则获取当前登录用户的时间线。

当提供搜索关键词时,会调用 /search/user_timeline.json 接口进行搜索。

Args: user_id: 用户 ID,如果为空则获取当前用户时间线 max_id: 返回列表中内容最新 ID,用于分页获取更早的内容 count: 获取数量,默认 5 条 q: 搜索关键词,如果为空则获取普通用户时间线;如果不为空则搜索该用户包含该关键词的消息

Returns: 用户时间线列表,每个元素包含: - 饭否内容: 消息文本内容(HTML 格式) * 转发:以「转@」开头,后跟用户链接,如 转@kingcos,其中 href 中的是用户 ID,inner Text 是被转发用户的显示名称,一条饭否可能有多个转发 * 话题:以「#」包围,如 #正在播放#,其中 q/ 后面的是话题名,一条饭否可能有多个话题 * 审核状态:如果内容末尾显示「【审核中】」,表示该内容正在审核中 - 发布 ID: 消息的唯一标识符 - 发布时间: 消息发布时间,需转为北京时间 - 发布者: 发布者的用户名 - 发布者 ID: 发布者的用户 ID - 图片链接: 如果包含图片,则提供图片链接

get_home_timelineA

获取当前用户首页关注用户及自己的饭否时间线

调用饭否 API 的 /statuses/home_timeline.json 接口获取当前用户的首页时间线, 包含用户关注的所有人的最新消息。

注:通常用户询问「我的饭否」时,指的是该时间线,除非用户明确指出「某个用户的饭否」。

Args: count: 获取数量,默认 5 条 max_id: 返回列表中内容最新 ID,用于分页获取更早的内容

Returns: 首页时间线列表,每个元素包含: - 饭否内容: 消息文本内容(HTML 格式) * 转发:以「转@」开头,后跟用户链接,如 转@kingcos,其中 href 中的是用户 ID,inner Text 是被转发用户的显示名称,一条饭否可能有多个转发 * 话题:以「#」包围,如 #正在播放#,其中 q/ 后面的是话题名,一条饭否可能有多个话题 * 审核状态:如果内容末尾显示「【审核中】」,表示该内容正在审核中 - 发布 ID: 消息的唯一标识符 - 发布时间: 消息发布时间,需转为北京时间 - 发布者: 发布者的用户名 - 发布者 ID: 发布者的用户 ID - 图片链接: 如果包含图片,则提供图片链接

get_public_timelineA

获取公开时间线

调用饭否 API 的 /statuses/public_timeline.json 接口获取饭否全站最新的公开消息, 这些是所有用户可见的公开饭否内容。

当提供搜索关键词时,会调用 /search/public_timeline.json 接口进行搜索。

Args: count: 获取数量,默认 5 条 max_id: 返回列表中内容最新 ID,用于分页获取更早的内容 q: 搜索关键词,如果为空则获取普通公开时间线;如果不为空则搜索包含该关键词的公开消息

Returns: 公开时间线列表,每个元素包含: - 饭否内容: 消息文本内容(HTML 格式) * 转发:以「转@」开头,后跟用户链接,如 转@kingcos,其中 href 中的是用户 ID,inner Text 是被转发用户的显示名称,一条饭否可能有多个转发 * 话题:以「#」包围,如 #正在播放#,其中 q/ 后面的是话题名,一条饭否可能有多个话题 * 审核状态:如果内容末尾显示「【审核中】」,表示该内容正在审核中 - 发布 ID: 消息的唯一标识符 - 发布时间: 消息发布时间,需转为北京时间 - 发布者: 发布者的用户名 - 发布者 ID: 发布者的用户 ID - 图片链接: 如果包含图片,则提供图片链接

get_user_infoA

获取用户信息

调用饭否 API 的 /users/show.json 接口获取指定用户的详细信息。 如果 user_id 为空,则获取当前登录用户的信息。

Args: user_id: 用户 ID,如果为空则获取当前用户信息

Returns: 用户信息字典,包含: - 用户 ID: 用户的唯一标识符 - 用户名: 用户名 - 位置: 用户所在位置 - 性别: 用户性别 - 生日: 用户生日 - 描述: 用户个人描述 - 头像: 用户头像链接 - 链接: 用户个人网站链接 - 是否加锁: 账号是否受保护 - 粉丝数: 被关注数量 - 朋友数: 互相关注数量 - 收藏数: 收藏的消息数量 - 发布数: 发布的消息数量 - 照片数: 发布的照片数量 - 是否关注: 当前用户是否关注该用户 - 注册时间: 账号注册时间 - 最新状态: 用户最新发布的消息信息

get_status_infoA

获取某条饭否内容的具体信息

调用饭否 API 的 /statuses/show/id.json 接口获取指定饭否内容的详细信息。

Args: status_id: 饭否内容的 ID

Returns: 饭否内容的详细信息字典,包含: - 饭否内容: 消息文本内容(HTML 格式) * 转发:以「转@」开头,后跟用户链接,如 转@kingcos,其中 href 中的是用户 ID,inner Text 是被转发用户的显示名称,一条饭否可能有多个转发 * 话题:以「#」包围,如 #正在播放#,其中 q/ 后面的是话题名,一条饭否可能有多个话题 * 审核状态:如果内容末尾显示「【审核中】」,表示该内容正在审核中 - 发布 ID: 消息的唯一标识符 - 发布时间: 消息发布时间,需转为北京时间 - 发布者: 发布者的显示名称 - 发布者 ID: 发布者的用户 ID - 是否收藏: 当前用户是否收藏了该消息 - 是否是自己: 是否是当前用户发布的消息 - 发布位置: 消息发布的地理位置 - 回复信息: 如果是回复消息,包含被回复的状态 ID、用户 ID 和用户名 - 图片base64: 如果包含图片,则提供图片的 base64 编码(data URL 格式) - 图片链接: 如果包含图片,则提供原始图片链接作为备用

manage_favoriteA

管理饭否内容的收藏状态

调用饭否 API 的 /favorites/create/id.json 或 /favorites/destroy/id.json 接口 来收藏或取消收藏指定的饭否内容。

Args: status_id: 饭否内容的 ID action: 操作类型,"create" 表示收藏,"destroy" 表示取消收藏 confirm: 是否确认操作(二次确认参数)

Returns: 操作结果字典,包含: - 是否收藏: 操作后的收藏状态 - 操作结果: 操作是否成功的描述信息 - 操作类型: 执行的具体操作(收藏/取消收藏)

或者确认信息字典,包含:
- 需要确认: 是否需要用户确认
- 内容预览: 要操作的内容预览
- 确认提示: 如何进行确认的说明
manage_friendshipA

管理用户关注状态

调用饭否 API 的 /friendships/create.json 或 /friendships/destroy.json 接口 来关注或取消关注指定用户。

注意:在执行关注操作前,会先调用 get_user_info 查询目标用户信息, 如果目标用户账号受保护(protected),关注操作将变为申请关注, 需要对方确认后才能生效。

Args: user_id: 目标用户的 ID action: 操作类型,"create" 表示关注,"destroy" 表示取消关注 confirm: 是否确认操作(二次确认参数)

Returns: 操作结果字典,包含: - 是否关注: 操作后的关注状态 - 操作结果: 操作是否成功的描述信息 - 操作类型: 执行的具体操作(关注/取消关注) - 用户信息: 目标用户的基本信息 - 特殊情况: 如果是受保护账号的关注申请,会包含相关提示

或者确认信息字典,包含:
- 需要确认: 是否需要用户确认
- 用户预览: 要操作的用户预览
- 确认提示: 如何进行确认的说明
publish_statusA

发布饭否内容(仅文字)

调用饭否 API 的 /statuses/update.json 接口发布纯文字内容。

Args: status: 要发布的文字内容(最多140字) confirm: 是否确认发布(二次确认参数)

Returns: 发布结果字典,包含: - 发布 ID: 新发布消息的唯一标识符 - 发布时间: 消息发布时间,需转为北京时间 - 发布结果: 发布是否成功的描述信息 - 重要提示: 关于审核的提醒信息

或者确认信息字典,包含:
- 需要确认: 是否需要用户确认
- 内容预览: 要发布的内容预览
- 确认提示: 如何进行确认的说明
publish_photoA

发布饭否内容(文字+图片)

调用饭否 API 的 /photos/upload.json 接口发布带图片的内容。

Args: status: 要发布的文字内容(最多140字) photo_url: 图片的网络 URL 地址 confirm: 是否确认发布(二次确认参数)

Returns: 发布结果字典,包含: - 发布 ID: 新发布消息的唯一标识符 - 发布时间: 消息发布时间 - 发布结果: 发布是否成功的描述信息 - 重要提示: 关于审核的提醒信息

或者确认信息字典,包含:
- 需要确认: 是否需要用户确认
- 内容预览: 要发布的内容预览
- 确认提示: 如何进行确认的说明
delete_statusA

删除饭否内容

调用饭否 API 的 /statuses/destroy.json 接口删除指定的饭否内容。 注意:只能删除自己发布的内容。

Args: status_id: 要删除的饭否内容的 ID confirm: 是否确认删除(二次确认参数)

Returns: 删除结果字典,包含: - 删除 ID: 被删除消息的 ID - 删除结果: 删除是否成功的描述信息 - 重要提示: 关于删除操作的提醒信息

或者确认信息字典,包含:
- 需要确认: 是否需要用户确认
- 内容预览: 要删除的内容预览
- 确认提示: 如何进行确认的说明

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kingcos/fanfou-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server