Skill: yesilsin-netizen/find-api (version 0.0.2)

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

path: README.md
content: # 🔍 Find API Skill

## 定位

这是一个**持续完善的通用数据源发现 Skill**。

**核心使命**：帮助 Agent 找到可靠的数据 API，避免低效的网页爬取。

## 设计原则

1. **API First, Scraping Last**：始终优先使用 API
2. **持续扩展**：不断添加新的数据领域
3. **实用性优先**：优先推荐免费、免认证、易用的 API
4. **Agent友好**：结构清晰，易于 Agent 理解和执行

## 当前覆盖领域

| 领域 | 状态 | 主要 API |
|------|------|---------|
| ✅ 股票/金融数据 | 完成 | AKShare, Tushare, yfinance |
| ✅ 天气数据 | 完成 | OpenWeatherMap, 和风天气 |
| ✅ 新闻媒体 | 完成 | NewsAPI, GNews |
| ✅ 地图定位 | 完成 | Nominatim, 高德地图 |
| ✅ 电商商品 | 基础完成 | 淘宝/京东开放平台 |
| 🔜 社交媒体 | 计划中 | Twitter, Weibo, Reddit |
| 🔜 翻译服务 | 计划中 | DeepL, Google Translate |
| 🔜 图像视频 | 计划中 | Unsplash, Pexels |
| 🔜 科研数据 | 计划中 | arXiv, PubMed |
| 🔜 政府公开数据 | 计划中 | 各国政府开放数据 |

## 如何贡献

如果你知道某个领域的可靠数据 API，欢迎贡献：

1. 提供 API 名称、官方链接
2. 说明数据覆盖范围
3. 说明成本和认证方式
4. 提供简单的使用示例

## 文件结构

```
find-api/
├── SKILL.md      # Skill 主文件
└── README.md     # 本说明文件
```

## 上传到 ClawHub

1. 访问 ClawHub
2. 创建新 Skill
3. 上传 `SKILL.md`
4. 填写信息：
   - Name: `find-api`
   - Emoji: `🔍`

## 版本历史

- v1.0.0 (2026-03-13): 初始版本
  - 覆盖股票/金融、天气、新闻、地图、电商五大领域
  - 提供详细的 API 对比和使用示例
  - 建立"API First, Scraping Last"核心原则


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)