{
  "markdown": "# OpenClaw AkShare Skill\n\nChinese financial data access using AkShare library for OpenClaw.\n\n## Overview\n\nThis skill provides easy access to Chinese financial market data through the [AkShare](https://akshare.akfamily.xyz/) library. It supports real-time and historical data for:\n\n- **A-shares (A股)**: Shanghai and Shenzhen stock exchanges\n- **Hong Kong stocks (港股)**: HKEX\n- **US stocks (美股)**: US market data\n- **Futures (期货)**: Commodity and index futures\n- **Funds (基金)**: Open-end and ETF funds\n- **Macroeconomic indicators (宏观)**: GDP, CPI, PMI, and more\n\n## Installation\n\n### Prerequisites\n\n- Python 3.7+\n- OpenClaw framework\n\n### Install AkShare\n\n```bash\npip install akshare\n```\n\nOr use the provided installation script:\n\n```bash\nbash scripts/install_akshare.sh\n```\n\n### Install the Skill\n\nCopy this skill to your OpenClaw workspace:\n\n```bash\ncp -r openclaw-akshare-skill /path/to/openclaw/workspace/skills/akshare\n```\n\n## Quick Start\n\n### Basic Stock Quote\n\n```python\nimport akshare as ak\n\n# Get all A-shares real-time data\ndf = ak.stock_zh_a_spot_em()\nprint(df.head())\n```\n\n### Historical Stock Data\n\n```python\n# Get historical daily data for a specific stock\ndf = ak.stock_zh_a_hist(\n    symbol=\"000001\",\n    period=\"daily\",\n    start_date=\"20240101\",\n    end_date=\"20241231\",\n    adjust=\"qfq\"  # Forward adjustment\n)\nprint(df.tail())\n```\n\n## Features\n\n### Stock Data\n\n- **Real-time quotes**: All A-shares, Hong Kong stocks, US stocks\n- **Historical data**: Daily, weekly, monthly periods with price adjustment\n- **Stock list**: Complete stock code and name information\n\n### Futures Data\n\n- Commodity futures real-time data\n- Historical futures data from major exchanges\n\n### Fund Data\n\n- Open-end fund information\n- Fund historical net value trends\n\n### Macroeconomic Indicators\n\n- GDP, CPI, PPI, PMI\n- Economic calendar and indicators\n\n## Common Parameters\n\n### Period (周期)\n\n- `daily` - Daily (日线)\n- `weekly` - Weekly (周线)\n- `monthly` - Monthly (月线)\n\n### Price Adjustment (复权)\n\n- `qfq` - Forward adjustment (前复权)\n- `hfq` - Backward adjustment (后复权)\n- `\"\"` - No adjustment (不复权)\n\n## Examples\n\nSee the `scripts/` directory for more examples:\n\n- `example_usage.py` - Common usage examples\n- `test_basic.py` - Basic functionality tests\n- `test_quick.py` - Quick start examples\n\n## Documentation\n\n- [SKILL.md](SKILL.md) - Complete skill documentation\n- [references/akshare_api.md](references/akshare_api.md) - Detailed API reference\n- [references/common_functions.md](references/common_functions.md) - Commonly used functions\n- [Official AkShare Docs](https://akshare.akfamily.xyz/)\n\n## Tips\n\n1. **Data caching**: AkShare doesn't cache data by default. Implement your own caching if needed\n2. **Rate limiting**: Be mindful of request frequency to avoid being blocked\n3. **Data format**: Returns pandas DataFrame, can be easily processed\n4. **Error handling**: Network errors may occur, implement retry logic\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details\n\n## Contributing\n\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for version history.\n\n## Acknowledgments\n\n- [AkShare](https://akshare.akfamily.xyz/) - The underlying Python library for Chinese financial data\n- [OpenClaw](https://github.com/openclaw/openclaw) - The AI assistant framework\n\n## Support\n\nFor issues and questions:\n- Open an issue on GitHub\n- Check [AkShare documentation](https://akshare.akfamily.xyz/)\n- Review the examples in the `scripts/` directory",
  "bytes": 3539,
  "sha": "b7b98331db2867ed9f0496885d592cdf4bbbfc70b3cafd153e7aa4d5e6677f5f",
  "repo_slug": "succ985/openclaw-akshare-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_succ985_openclaw_akshare_skill_akshare_ce04dee2/readme"
}