# Readme Craft Agent API

Readme Craft generates and deploys GitHub Profile README files.

Base URL: https://aidulia.cn/agent/v1

Primary endpoints:
- POST /generate
- POST /deploy
- GET /styles

Generate a README:
- Endpoint: POST https://aidulia.cn/agent/v1/generate
- Required field: username
- Optional fields: message, style, extra_info, exclude_styles

Deploy a README:
- Endpoint: POST https://aidulia.cn/agent/v1/deploy
- Required fields: username, readme_content, github_token
- Use a GitHub token from the calling agent's secure environment.
- The token is sent only to the backend deploy endpoint. Do not include tokens in prompts, logs, or frontend code.

Human users should use the web OAuth flow at https://aidulia.cn/.
AI agents can call the Agent API directly. If username, readme_content, and a valid github_token are available, agents may call /deploy without a human preview step.

Docs: https://aidulia.cn/agent
OpenAPI: https://aidulia.cn/openapi.json