kicktipp代理
CLI和MCP服务器 kicktipp.com --德国足球预测游戏。从终端查看排行榜、日程表、排名表和下注，或者让AI代理为您完成。
为什么？
Kicktipp没有公开的API。一切都通过网站。此项目为您提供了两种跳过浏览器的方法：
- 命令行界面 --在终端查看分数、排名，并在几秒钟内下注。无需点击页面，无需等待广告加载。可用于在比赛日进行快速查找或编写预测脚本。
- MCP服务器 --将AI助手（Claude Desktop、Claude Code或任何MCP客户端）连接到您的kicktipp帐户。让它显示今天的比赛，检查谁在你的联赛中领先，或者为你下注——所有这些都是通过自然的对话。助手会看到您社区的数据，但不会看到您的密码。
带有会话缓存的Headless Chromium使事情保持快速。首次登录后，后续命令将重用已保存的会话，并完全跳过登录流程。
安装
npm install
npx playwright install chromium
npm run build
npm link这将为您提供两个命令：
kicktipp--CLIkicktipp-mcp--MCP服务器
命令行界面
首次设置
首次运行时，CLI会提示您输入kicktipp.com电子邮件和密码。凭据存储在本地 ~/.config/kicktipp-agent/config.ini （600克）。
$ kicktipp set-community
No credentials found. Please enter your kicktipp.com login:
Email: you@example.com
Password: ********
Credentials saved to ~/.config/kicktipp-agent/config.ini
Available communities:
[1] testspiel
[2] bundesliga-tipps
Select community (1-2): 1
Saved 'testspiel' as default community.您可以选择设置您的玩家名称，以便排行榜突出显示您的位置：
$ kicktipp set-player命令
| 命令 | 描述 |
|---|---|
communities | 列出您所属的所有社区 |
set-community | 选择默认社区 |
players | 列出已保存社区中的玩家 |
set-player | 选择您是哪位玩家 |
leaderboard | 显示比赛日排行榜 |
overview | 显示季节概览 |
schedule | 显示比赛日程 |
table | 显示排名表 |
bets | 展示你在比赛日的赌注 |
bet | 下注（互动、按赛程或奖金） |
today | 显示今天的比赛以及哪些比赛仍需要投注 |
rules | 显示游戏规则 |
guide | 打印详细的使用指南（对LLM代理有用） |
logout | 删除存储的凭据和会话 |
下注
# Interactive — prompts for each match
kicktipp bet
# By fixture name (get exact names from `kicktipp bets`)
kicktipp bet "FC Bayern München vs Borussia Dortmund=2:1"
kicktipp bet "RB Leipzig vs Bayer 04 Leverkusen=0:0" --matchday 5
# Bonus questions — interactive
kicktipp bet --bonus
# Bonus questions — by name
kicktipp bet --bonus "Who will win the league?=FC Bayern München"选项
--matchday--设定一个特定的比赛日（1-34）--bonus--奖金问题排名（含leaderboard)或奖金投注（与bet)--view--概述类型（带overview)--home/--away--家用/家用过滤器（带table)
MCP服务器
MCP服务器通过以下方式公开与CLI相同的功能 模型上下文协议，允许像Claude这样的人工智能助手代表您与kicktipp.com进行交互。
可用工具
| 工具 | 说明 |
|---|---|
get_status | 检查是否配置了凭据和社区 |
get_today_matches | 今天有投注状态的比赛 |
get_bets | 比赛日的比赛和当前投注 |
get_schedule | 将时间表与结果相匹配 |
get_leaderboard | 比赛日球员排名 |
get_overview | 所有比赛日的赛季概览 |
get_table | 联赛表（实际足球排名） |
get_rules | 游戏规则和评分系统 |
get_communities | 列出用户所属的社区 |
get_players | 列出社区中的玩家 |
get_bonus_questions | 附带选项的奖励问题 |
set_community | 建立活跃的社区 |
set_player | 设置你是哪个玩家 |
place_bets | 按赛程名称下注 |
place_bonus_bets | 放置奖金问题答案 |
使用Claude Desktop进行设置
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"kicktipp": {
"command": "kicktipp-mcp",
"env": {
"KICKTIPP_EMAIL": "you@example.com",
"KICKTIPP_PASSWORD": "yourpassword"
}
}
}
}这 env 该块将凭据直接传递给服务器进程——克劳德永远看不到它们。如果你愿意，可以省略 env 而是通过CLI设置凭据(kicktipp set-community).
重启Claude Desktop后，代理将可以访问所有kicktipp工具。它会召唤 get_status 首先检查配置，然后根据需要提示您设置社区。
使用Claude代码进行设置
添加 .mcp.json 在您的主目录或项目中：
{
"mcpServers": {
"kicktipp": {
"command": "kicktipp-mcp",
"env": {
"KICKTIPP_EMAIL": "you@example.com",
"KICKTIPP_PASSWORD": "yourpassword"
}
}
}
}凭证
MCP服务器以两种方式接受凭据（按此顺序检查）：
- 环境变量 —
KICKTIPP_EMAIL和KICKTIPP_PASSWORD通过envMCP客户端配置中的块 - 配置文件 —
~/.config/kicktipp-agent/config.ini，与CLI共享
如果两者都没有找到，服务器将返回一个错误，指导代理通知您。
发展
npm test # run tests
npm run build # compile TypeScript积分
最初分叉自 施维尔/kicktipp betbot 斯特凡。此后，该项目已完全用TypeScript重写，使用了新的CLI接口、MCP服务器和基于Cheerio的解析。