{"skill":{"slug":"find-api","displayName":"Find API","summary":"🔍 Find API | 寻找可靠数据源 TRIGGERS: Use when agent needs to fetch external data, user mentions \"reliable data source\", \"数据源\", \"API\", or when web scraping is inef...","description":"---\r\nname: find-api\r\ndescription: |\r\n  🔍 Find API | 寻找可靠数据源\r\n  \r\n  TRIGGERS: Use when agent needs to fetch external data, user mentions \"reliable data source\", \"数据源\", \"API\", or when web scraping is inefficient/inaccurate.\r\n  \r\n  A comprehensive guide to reliable data APIs across all domains.\r\n  Helps agents find the best APIs instead of inefficient web scraping.\r\n  Currently covers: Stock/Financial data, Weather, News, Maps, and more domains coming soon.\r\n  \r\n  触发条件：Agent 需要获取外部数据、用户提到\"可靠数据源\"、\"数据源\"、\"API\"，或网页爬取效率低/不准确时。\r\n  跨领域可靠数据 API 的综合指南。\r\n  帮助 Agent 找到最佳 API，避免低效的网页爬取。\r\n  目前覆盖：股票/金融数据、天气、新闻、地图，更多领域持续完善中。\r\n\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🔍\",\"triggers\":[\"api\",\"数据源\",\"data source\",\"reliable\",\"可靠\",\"scrape\",\"爬取\",\"fetch\",\"获取\",\"stock\",\"股票\",\"weather\",\"天气\",\"news\",\"新闻\",\"map\",\"地图\",\"price\",\"价格\",\"financial\",\"金融\"],\"categories\":[\"infrastructure\",\"data-access\",\"efficiency\"]}}\r\n---\r\n\r\n# 🔍 Find API | 寻找可靠数据源\r\n\r\n> The comprehensive guide to reliable data APIs. Stop scraping, start using APIs.\r\n> \r\n> 跨领域可靠数据 API 的综合指南。停止爬取，开始使用 API。\r\n\r\n## ⚠️ Core Principle | 核心原则\r\n\r\n**API First, Scraping Last.**\r\n\r\n| Priority | Method | When to Use | 优先级 | 方法 | 何时使用 |\r\n|----------|--------|-------------|--------|------|---------|\r\n| **1st** | Official API | Always check first | **第一** | 官方 API | 始终优先检查 |\r\n| **2nd** | Third-party API | When official API unavailable/expensive | **第二** | 第三方 API | 当官方 API 不可用/太贵 |\r\n| **3rd** | Public Dataset | For historical/static data | **第三** | 公共数据集 | 用于历史/静态数据 |\r\n| **4th** | Web Scraping | Only as last resort | **第四** | 网页爬取 | 仅作为最后手段 |\r\n\r\n## 📋 Table of Contents | 目录\r\n\r\n1. [Stock & Financial Data | 股票与金融数据](#1-stock--financial-data--股票与金融数据)\r\n2. [Weather Data | 天气数据](#2-weather-data--天气数据)\r\n3. [News & Media | 新闻与媒体](#3-news--media--新闻与媒体)\r\n4. [Maps & Geolocation | 地图与地理定位](#4-maps--geolocation--地图与地理定位)\r\n5. [E-commerce & Products | 电商与商品](#5-e-commerce--products--电商与商品)\r\n6. [More domains coming soon... | 更多领域持续完善中...](#6-more-domains-coming-soon--更多领域持续完善中)\r\n\r\n---\r\n\r\n## 1. Stock & Financial Data | 股票与金融数据\r\n\r\n### 1.1 A股市场 / Chinese A-Share Market\r\n\r\n| API | Rating | Cost | Auth | Data Coverage |\r\n|-----|--------|------|------|---------------|\r\n| **AKShare** | ⭐⭐⭐⭐⭐ | Free | None | Real-time quotes, historical K-lines, financial statements, fund flows, dragon-tiger list |\r\n| **Tushare** | ⭐⭐⭐⭐⭐ | Free+Paid | Token | Real-time quotes, historical data, financial statements, margin trading |\r\n| **East Money API** | ⭐⭐⭐⭐ | Free | None | Real-time quotes, fund flows, research reports |\r\n\r\n**Recommended: AKShare** (Best for most use cases)\r\n\r\n**Installation:**\r\n```bash\r\npip install akshare\r\n```\r\n\r\n**Quick Examples:**\r\n```python\r\nimport akshare as ak\r\n\r\n# 获取A股实时行情\r\ndf = ak.stock_zh_a_spot_em()\r\n\r\n# 获取个股历史数据\r\ndf = ak.stock_zh_a_hist(symbol=\"000001\", period=\"daily\", adjust=\"qfq\")\r\n\r\n# 获取财务指标\r\ndf = ak.stock_financial_analysis_indicator(symbol=\"000001\")\r\n\r\n# 获取资金流向\r\ndf = ak.stock_individual_fund_flow(stock=\"000001\")\r\n```\r\n\r\n**Documentation:** https://akshare.akfamily.xyz\r\n\r\n---\r\n\r\n### 1.2 港股市场 / Hong Kong Stock Market\r\n\r\n| API | Rating | Cost | Auth | Data Coverage |\r\n|-----|--------|------|------|---------------|\r\n| **AKShare** | ⭐⭐⭐⭐⭐ | Free | None | Real-time quotes, historical data |\r\n| **Tushare** | ⭐⭐⭐⭐ | Free+Paid | Token | Hong Kong stock data |\r\n\r\n**Recommended: AKShare**\r\n\r\n**Quick Examples:**\r\n```python\r\nimport akshare as ak\r\n\r\n# 港股实时行情\r\ndf = ak.stock_hk_spot_em()\r\n\r\n# 个股历史数据（如腾讯 00700）\r\ndf = ak.stock_hk_hist(symbol=\"00700\", period=\"daily\", adjust=\"qfq\")\r\n\r\n# 港股通资金\r\ndf = ak.stock_hk_ggt_components_em()\r\n```\r\n\r\n---\r\n\r\n### 1.3 美股市场 / US Stock Market\r\n\r\n| API | Rating | Cost | Auth | Data Coverage |\r\n|-----|--------|------|------|---------------|\r\n| **yfinance** | ⭐⭐⭐⭐⭐ | Free | None | Real-time quotes, historical data, financials, options |\r\n| **Alpha Vantage** | ⭐⭐⭐⭐ | Free+Paid | API Key | Quotes, technical indicators, forex |\r\n| **Polygon.io** | ⭐⭐⭐⭐ | Free+Paid | API Key | Real-time data, options |\r\n\r\n**Recommended: yfinance** (Best free option for US stocks)\r\n\r\n**Installation:**\r\n```bash\r\npip install yfinance\r\n```\r\n\r\n**Quick Examples:**\r\n```python\r\nimport yfinance as yf\r\n\r\n# 获取股票信息\r\nstock = yf.Ticker(\"AAPL\")\r\n\r\n# 历史数据\r\nhist = stock.history(period=\"1mo\")\r\n\r\n# 财务报表\r\nfinancials = stock.financials\r\nbalance_sheet = stock.balance_sheet\r\ncashflow = stock.cashflow\r\n\r\n# 股息信息\r\ndividends = stock.dividends\r\n\r\n# 推荐分析师评级\r\nrecommendations = stock.recommendations\r\n```\r\n\r\n**Documentation:** https://github.com/ranaroussi/yfinance\r\n\r\n---\r\n\r\n### 1.4 期货与衍生品 / Futures & Derivatives\r\n\r\n| API | Rating | Cost | Auth | Data Coverage |\r\n|-----|--------|------|------|---------------|\r\n| **AKShare** | ⭐⭐⭐⭐⭐ | Free | None | Domestic futures, international futures |\r\n| **Tushare** | ⭐⭐⭐⭐ | Free+Paid | Token | Futures data |\r\n\r\n**Quick Examples:**\r\n```python\r\nimport akshare as ak\r\n\r\n# 国内期货主力合约\r\ndf = ak.futures_zh_main_sina()\r\n\r\n# 国际期货\r\ndf = ak.futures_foreign_hist(symbol=\"CL\")  # 原油\r\n```\r\n\r\n---\r\n\r\n### 1.5 基金数据 / Fund Data\r\n\r\n| API | Rating | Cost | Auth | Data Coverage |\r\n|-----|--------|------|------|---------------|\r\n| **AKShare** | ⭐⭐⭐⭐⭐ | Free | None | Open-end funds, ETFs, money funds |\r\n| **East Money API** | ⭐⭐⭐⭐ | Free | None | Fund rankings, holdings |\r\n\r\n**Quick Examples:**\r\n```python\r\nimport akshare as ak\r\n\r\n# 开放式基金列表\r\ndf = ak.fund_open_fund_info_em(fund=\"000001\")\r\n\r\n# ETF实时行情\r\ndf = ak.fund_etf_spot_em()\r\n\r\n# 基金持仓\r\ndf = ak.fund_portfolio_em(fund=\"000001\")\r\n```\r\n\r\n---\r\n\r\n## 2. Weather Data | 天气数据\r\n\r\n| API | Rating | Cost | Auth | Data Coverage |\r\n|-----|--------|------|------|---------------|\r\n| **OpenWeatherMap** | ⭐⭐⭐⭐⭐ | Free+Paid | API Key | Current weather, forecast, historical |\r\n| **WeatherAPI.com** | ⭐⭐⭐⭐ | Free+Paid | API Key | Weather, astronomy, sports |\r\n| **QWeather 和风天气** | ⭐⭐⭐⭐ | Free+Paid | API Key | 中国地区天气数据 |\r\n\r\n**Recommended: OpenWeatherMap** (Global coverage)\r\n\r\n**Quick Examples:**\r\n```python\r\nimport requests\r\n\r\napi_key = \"YOUR_API_KEY\"\r\ncity = \"Beijing\"\r\n\r\n# 当前天气\r\nurl = f\"https://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}&units=metric\"\r\nresponse = requests.get(url)\r\ndata = response.json()\r\n\r\nprint(f\"Temperature: {data['main']['temp']}°C\")\r\nprint(f\"Weather: {data['weather'][0]['description']}\")\r\n```\r\n\r\n**Get API Key:** https://openweathermap.org/api\r\n\r\n---\r\n\r\n## 3. News & Media | 新闻与媒体\r\n\r\n| API | Rating | Cost | Auth | Data Coverage |\r\n|-----|--------|------|------|---------------|\r\n| **NewsAPI** | ⭐⭐⭐⭐⭐ | Free+Paid | API Key | Global news articles |\r\n| **GNews** | ⭐⭐⭐⭐ | Free+Paid | API Key | News articles, search |\r\n| **MediaStack** | ⭐⭐⭐⭐ | Free+Paid | API Key | News data |\r\n\r\n**Recommended: NewsAPI**\r\n\r\n**Quick Examples:**\r\n```python\r\nimport requests\r\n\r\napi_key = \"YOUR_API_KEY\"\r\n\r\n# 获取头条新闻\r\nurl = f\"https://newsapi.org/v2/top-headlines?country=us&apiKey={api_key}\"\r\nresponse = requests.get(url)\r\narticles = response.json()['articles']\r\n\r\nfor article in articles[:5]:\r\n    print(article['title'])\r\n```\r\n\r\n**Get API Key:** https://newsapi.org\r\n\r\n---\r\n\r\n## 4. Maps & Geolocation | 地图与地理定位\r\n\r\n| API | Rating | Cost | Auth | Data Coverage |\r\n|-----|--------|------|------|---------------|\r\n| **OpenStreetMap Nominatim** | ⭐⭐⭐⭐⭐ | Free | None | Geocoding, reverse geocoding |\r\n| **高德地图 API** | ⭐⭐⭐⭐⭐ | Free+Paid | API Key | 中国地区地图、导航、POI |\r\n| **百度地图 API** | ⭐⭐⭐⭐ | Free+Paid | API Key | 中国地区地图、导航 |\r\n| **Google Maps API** | ⭐⭐⭐⭐ | Paid | API Key | Global maps, places, routes |\r\n\r\n**Recommended: Nominatim** (Free, no auth) | **高德地图** (中国地区)\r\n\r\n**Nominatim Quick Examples:**\r\n```python\r\nimport requests\r\n\r\n# 地理编码（地址转坐标）\r\naddress = \"Beijing, China\"\r\nurl = f\"https://nominatim.openstreetmap.org/search?q={address}&format=json\"\r\nresponse = requests.get(url, headers={'User-Agent': 'AgentApp'})\r\ndata = response.json()\r\n\r\nprint(f\"Lat: {data[0]['lat']}, Lon: {data[0]['lon']}\")\r\n```\r\n\r\n**高德地图 Quick Examples:**\r\n```python\r\nimport requests\r\n\r\napi_key = \"YOUR_API_KEY\"\r\naddress = \"北京市朝阳区\"\r\n\r\n# 地理编码\r\nurl = f\"https://restapi.amap.com/v3/geocode/geo?address={address}&key={api_key}\"\r\nresponse = requests.get(url)\r\ndata = response.json()\r\n\r\nprint(data['geocodes'][0]['location'])\r\n```\r\n\r\n**Get 高德 API Key:** https://lbs.amap.com\r\n\r\n---\r\n\r\n## 5. E-commerce & Products | 电商与商品\r\n\r\n| API | Rating | Cost | Auth | Data Coverage |\r\n|-----|--------|------|------|---------------|\r\n| **淘宝开放平台** | ⭐⭐⭐⭐ | Free+Paid | OAuth | 商品搜索, 订单 |\r\n| **京东开放平台** | ⭐⭐⭐⭐ | Free+Paid | OAuth | 商品, 订单, 物流 |\r\n| **Barcode Lookup** | ⭐⭐⭐ | Free+Paid | API Key | Product info by barcode |\r\n\r\n**Note:** 电商API通常需要商家认证，普通用户可考虑爬取商品页面或使用第三方服务。\r\n\r\n---\r\n\r\n## 6. More domains coming soon... | 更多领域持续完善中\r\n\r\n**Planned additions:**\r\n- Social Media APIs (Twitter, Weibo, Reddit)\r\n- Translation APIs\r\n- Image & Video APIs\r\n- Scientific & Research Data APIs\r\n- Government & Public Data APIs\r\n- Real Estate Data APIs\r\n- Job & Recruitment APIs\r\n\r\n**Contribute:** If you know reliable APIs in other domains, help expand this skill!\r\n\r\n---\r\n\r\n## 🔄 Decision Flow | 决策流程\r\n\r\n```\r\n用户需要获取外部数据\r\n    ↓\r\nStep 1: 确定数据类型\r\n├── 股票/金融 → 查看本 Skill 第1节\r\n├── 天气 → 查看本 Skill 第2节\r\n├── 新闻 → 查看本 Skill 第3节\r\n├── 地图/位置 → 查看本 Skill 第4节\r\n├── 电商/商品 → 查看本 Skill 第5节\r\n└── 其他 → 搜索 RapidAPI / Public APIs\r\n    ↓\r\nStep 2: 选择合适的 API\r\n├── 考虑因素：成本、认证难度、数据覆盖、稳定性\r\n└── 优先选择免费/免认证的 API\r\n    ↓\r\nStep 3: 检查环境\r\n├── Python库是否安装？→ pip install xxx\r\n└── API Key是否获取？→ 引导用户注册\r\n    ↓\r\nStep 4: 调用 API 获取数据\r\n    ↓\r\nStep 5: 返回结构化结果\r\n```\r\n\r\n## 📊 Before vs After Comparison | 效果对比\r\n\r\n| Metric | Web Scraping | Using API |\r\n|--------|-------------|-----------|\r\n| **Speed** | 30-60 seconds | 1-3 seconds |\r\n| **Token Cost** | High (entire HTML) | Low (JSON only) |\r\n| **Accuracy** | Low (parsing errors) | High (structured data) |\r\n| **Reliability** | Low (anti-scraping) | High (stable API) |\r\n| **Maintenance** | High (page changes) | Low (stable API) |\r\n\r\n| 指标 | 网页爬取 | 使用 API |\r\n|------|---------|---------|\r\n| **速度** | 30-60 秒 | 1-3 秒 |\r\n| **Token 成本** | 高（整个页面） | 低（仅 JSON） |\r\n| **准确性** | 低（解析错误） | 高（结构化数据） |\r\n| **稳定性** | 低（反爬机制） | 高（稳定接口） |\r\n| **维护成本** | 高（页面变化） | 低（稳定接口） |\r\n\r\n## 🔧 General Setup | 通用安装\r\n\r\nMost APIs in this skill require Python. Basic setup:\r\n\r\n```bash\r\n# 常用数据获取库\r\npip install akshare yfinance requests pandas\r\n\r\n# 可选：更多数据源\r\npip install tushare\r\n```\r\n\r\n## 🔍 External Resources | 外部资源\r\n\r\nIf the data type is not covered in this skill, search these directories:\r\n\r\n| Resource | URL | Description |\r\n|----------|-----|-------------|\r\n| **RapidAPI** | https://rapidapi.com/hub | Largest API marketplace |\r\n| **Public APIs** | https://github.com/public-apis/public-apis | Free public APIs list |\r\n| **ProgrammableWeb** | https://www.programmableweb.com | API directory |\r\n\r\n## 📝 Version | 版本\r\n\r\n- Version: 1.0.0\r\n- Created: 2026-03-13\r\n- Last Updated: 2026-03-13\r\n- Maintainer: Community\r\n- Contribution: Welcome to add more reliable data sources\r\n\r\n---\r\n\r\n**Remember: API First, Scraping Last.**\r\n","topics":["Web Scraping","Financial","News","Stock","Weather"],"tags":{"latest":"0.0.2"},"stats":{"comments":0,"downloads":556,"installsAllTime":21,"installsCurrent":1,"stars":1,"versions":2},"createdAt":1773392692392,"updatedAt":1778491876821},"latestVersion":{"version":"0.0.2","createdAt":1773392933383,"changelog":"No changes detected in this version.\n\n- No file changes found between versions.\n- No updates to features, documentation, or behavior.","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"yesilsin-netizen","userId":"s176nc1pks498h6p6y452s9t4x83gp4p","displayName":"yesilsin-netizen","image":"https://avatars.githubusercontent.com/u/262531207?v=4"},"moderation":null}