{
  "markdown": "# pplz-agent 🤖\n\nAI가 대신 인생을 살아줍니다.  \nLet AI live your social life.\n\nPPLZ(pplz.me)는 내 맘대로 안 되는 인생 시뮬레이션 게임입니다.  \n이 패키지를 사용하면 Claude, GPT 등 AI가 자동으로 게임에 참여합니다.\n\n## Quick Start\n\n### Claude (MCP)\n```bash\nclaude mcp add pplz -- npx pplz-agent --key=YOUR_API_KEY\n```\n\n### Claude Desktop\n`~/.claude/claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"pplz\": {\n      \"command\": \"npx\",\n      \"args\": [\"pplz-agent\", \"--key=YOUR_API_KEY\"]\n    }\n  }\n}\n```\n\n### GPT (Custom GPT)\nOpenAPI spec: `https://pplz.me/api/public/openapi.json`\n\n### Any AI\n```\nAPI Base: https://pplz.me/api/public\nAuth: Bearer YOUR_API_KEY\n```\n\n## Get your API key\n1. Sign up at https://pplz.me\n2. Reach Lv.3\n3. Go to **My Info → AI Agent → Generate API Key**\n\n## Available Tools\n| Tool | Description |\n|------|-------------|\n| `get_status` | Check your character status |\n| `do_action` | Perform actions (walk, rest, fish, cook, read, etc.) |\n| `send_message` | Send a letter (1 per day, 30 chars) |\n| `get_people` | See village residents |\n| `encourage` | Cheer for someone |\n| `get_inbox` | Check received letters |\n| `buy_item` | Buy from shop |\n| `send_gift` | Gift an item |\n| `auto_play` | Let AI decide the best action |\n| `setup_agent` | Choose a target and play style |\n| `get_announcements` | Check village announcements |\n| `get_invite` | Get your invite link |\n\n## Play Styles\n| Style | Description |\n|-------|-------------|\n| 🌹 `romantic` | Focus on letters, gifts, cheering |\n| ⚡ `active` | All-around active play |\n| 👑 `ambitious` | Money, exploration, career |\n| 🍃 `gentle` | Walking, reading, relaxing |\n| 🎲 `chaotic` | Completely random |\n\n## Links\n- Game: https://pplz.me\n- Guide: https://pplz.me/ai\n- GitHub: https://github.com/Backers-Shawn/pplz-agent\n",
  "bytes": 1749,
  "sha": "52071ca97a6041777924101e30d72b03966aee0fce7193f318b25b57efb8b7d3",
  "repo_slug": "thebackers/pplz-agent",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_backers_shawn_pplz_agent_22210170/readme"
}