Epic Free Games

Auto-claim free games from Epic Games Store. 2026 latest page adaptation with persistent login state, completes the full claim process (Get → Place Order → C...

Security Scan

The skill's code and instructions are consistent with its stated purpose: local browser automation (via agent-browser) to claim Epic free games and persist login state; it does not request unrelated credentials or contact external endpoints in the provided files.

Purpose & Capability

Name/description (auto-claim Epic free games) align with the included script and SKILL.md. The script uses agent-browser to open the Epic store, save/load a local auth file, and click UI elements — all coherent with the stated purpose. The SKILL.md explicitly declares agent-browser as a requirement.

Instruction Scope

Instructions and code focus on opening the Epic free-games page, saving/loading epic_auth.json, taking snapshots, and clicking buttons. This is within the expected scope. Note: the use of snapshot/click commands means page content and interactive element data may be retrieved locally (and could include sensitive UI content); SKILL.md warns about sensitive auth files and manual CAPTCHA handling.

Install Mechanism

No install spec included; SKILL.md instructs installing agent-browser via npm (public package). No downloads from unknown URLs or archive extraction are present in the package itself.

Credentials

The skill requires no environment variables, no credentials, and no config paths beyond a local epic_auth.json file (created by user during --login). That local auth file is necessary for persistent login and is proportional to the functionality.

Persistence & Privilege

always is false and the skill does not request persistent platform-level privileges. It reads/writes a single local auth file in the project directory (epic_auth.json). It does not modify other skills or system-wide agent settings in the provided code.

Assessment

This skill appears coherent, but take these precautions before running: 1) Review the script yourself (or in a sandbox) before use — it will save your Epic auth state to epic_auth.json in the repository directory. 2) Never commit or share epic_auth.json; add it to .gitignore. 3) Install agent-browser from its official source and verify you trust that binary (it performs the browser automation). 4) Consider running this in an isolated VM/container and not on your primary account — automated claiming may violate Epic's Terms of Service and could trigger account actions. 5) Be prepared to handle hCaptcha/Cloudflare prompts manually (the skill cannot bypass them).

Epic Free Games Auto Claimer / Epic 免费游戏自动领取

Auto-claim weekly free games from Epic Games Store.

自动领取 Epic Games Store 每周免费游戏。

⚠️ Risk Warning / 风险提示

English:

• Account Risk: Automated tools may violate Epic's Terms of Service. Use at your own risk. Account suspension is possible.
• Human Verification: hCaptcha/Cloudflare verification cannot be bypassed automatically. Manual intervention required when prompted.
• Educational Purpose: This tool is for learning purposes only. Do not abuse it.
• No Warranty: Use at your own risk. The author is not responsible for any consequences.

中文：

• 账号风险：自动化工具可能违反 Epic 服务条款，使用风险自负。可能导致账号封禁。
• 人机验证：无法自动绕过 hCaptcha/Cloudflare 验证，需要手动处理。
• 仅供学习：本工具仅供学习研究使用，请勿滥用。
• 免责声明：使用风险自负，作者不对任何后果负责。

Features / 功能特点

• 2026 Latest Adaptation / 2026年最新适配 - Uses stable data-testid selectors / 使用稳定的 data-testid 选择器
• Persistent Login / 持久化登录 - Login once, works forever (saves cookies) / 一次登录，永久生效（保存 Cookie）
• Full Claim Process / 完整领取流程 - Get → Place Order → Confirm / 获取 → 0元下订单 → 确认领取
• Cron Support / 定时任务支持 - Auto-claim every Thursday / 每周四自动领取

Quick Start / 快速开始

# First time login (manual login required) / 首次登录（需要手动登录一次）
python scripts/claim.py --login

# Auto-claim free games / 自动领取免费游戏
python scripts/claim.py

# Show browser window (for captcha handling) / 显示浏览器窗口（用于处理验证码）
python scripts/claim.py --headed

# View help / 查看帮助
python scripts/claim.py --help

Usage Steps / 使用步骤

1. First Login / 首次登录

python scripts/claim.py --login

Opens browser window for manual Epic login. After login, auth state is saved to epic_auth.json.

打开浏览器窗口，手动登录 Epic 账号。登录完成后，登录状态会保存到 epic_auth.json。

2. Auto Claim / 自动领取

python scripts/claim.py

Automatically:

1. Opens Epic free games page / 打开 Epic 免费游戏页面
2. Loads saved auth state / 加载保存的登录状态
3. Clicks "Get" button / 点击"获取"按钮
4. Clicks "Place Order" for $0 purchase / 点击"下订单"完成 0 元购买
5. Confirms success / 确认领取成功

3. Cron Task / 定时任务

Set up cron for weekly auto-claim:

设置定时任务，每周四自动领取：

# Every Thursday at 00:20 / 每周四 00:20 执行
20 0 * * 4 cd /path/to/epic-free-games && python scripts/claim.py

CLI Arguments / 命令行参数

Argument	Description
--login	First-time login mode / 首次登录模式
--headed	Show browser window / 显示浏览器窗口
--timeout N	Wait timeout in seconds / 等待超时时间（秒）
--auth-file FILE	Auth state file path / 登录状态文件路径

Files / 文件说明

epic-free-games/
├── SKILL.md           # This file / 本说明文件
├── scripts/
│   └── claim.py       # Main script / 主脚本
└── epic_auth.json     # Auth state (auto-generated) / 登录状态缓存（自动生成）

Dependencies / 依赖

• agent-browser - Browser automation CLI / 浏览器自动化 CLI

Install / 安装：

npm install -g agent-browser
agent-browser install

Limitations / 限制

1. Cloudflare/hCaptcha - Cannot bypass automatically, use --headed for manual handling / 无法自动绕过，使用 --headed 手动处理
2. Login Expiry - Re-run --login if session expires / 登录过期时重新运行 --login
3. Already Owned - Script detects and skips owned games / 脚本会检测并跳过已拥有游戏

🔒 Security Best Practices / 安全最佳实践

IMPORTANT: This skill does NOT contain any pre-filled authentication files.

重要：本技能不包含任何预填充的认证文件。

For Users / 用户须知

1. Generate Your Own Auth File / 自行生成认证文件

   • Run python scripts/claim.py --login to create your own epic_auth.json
   • Never share your auth file with others / 不要分享你的认证文件
   • The auth file contains sensitive credentials / 认证文件包含敏感凭证

2. Keep Auth File Private / 保护认证文件

   • Add epic_auth.json to .gitignore if using git
   • Do not upload to public repositories / 不要上传到公开仓库

3. Isolated Environment / 隔离环境

   • Consider running in a sandbox or VM / 建议在沙箱或虚拟机中运行
   • Review the source code before running / 运行前请审查源代码

For Developers / 开发者须知

1. Never Commit Sensitive Files / 不要提交敏感文件

   # These files should NEVER be in the distribution:
   # 以下文件绝对不应出现在分发包中：
   - epic_auth.json
   - browser-profile/
   - browser_profile/
   - *.png (screenshots may contain sensitive info)
   

2. Use .gitignore / 使用 .gitignore

   • The skill includes a .gitignore file to prevent accidental commits
   • 本技能包含 .gitignore 文件，防止意外提交

3. Security First / 安全第一

   • User credentials are private / 用户凭证是私密的
   • Never bundle auth files in distributions / 分发时绝不要打包认证文件

Usage Tips / 使用技巧

Cloudflare 验证绕过

Epic 网站使用 Cloudflare 验证检测自动化访问。使用 --headed 显示浏览器窗口手动处理验证：

# 显示浏览器窗口 + 禁用自动化检测标志
agent-browser --headed --session epic \
  --args "--disable-blink-features=AutomationControlled" \
  open "https://store.epicgames.com/zh-CN/free-games"

推荐的手动 + 自动混合流程

1. 打开浏览器窗口 (自动)
2. 用户手动完成验证和登录 (手动)
3. 自动领取游戏 (自动)

agent-browser 常用命令

agent-browser --session epic snapshot -i  # 查看页面快照
agent-browser --session epic click "ref=e55"  # 点击元素
agent-browser --session epic close  # 关闭浏览器

License / 许可证

MIT License - Use at your own risk / 使用风险自负