模块一
基础认知：API 优先思维
你每天都在用各种软件和网站：刷 TikTok、发小红书、查 Google Trends、管理飞书文档。你已经很熟练了，鼠标点点、手指划划，一切尽在掌握。
但现在你有了一个新搭档——克总（Claude Code）。
克总很强，能帮你处理数据、写代码、搭网站、自动化各种重复工作。但有一件事你需要先搞清楚：克总和你"用软件"的方式完全不同。
理解这个区别，是你和克总高效协作的第一步。
两种"入口"：堂食 vs 外卖窗口
🍽️ 堂食（网页/App）
走进餐厅，坐下来，看菜单，跟服务员点菜，等厨房做好，端上来，吃完买单。每一步都需要你亲自参与。
= 打开浏览器，看页面，点按钮，填表单，等结果
📦 外卖窗口（API）
餐厅后面的外卖窗口。直接报编号："我要 3 号套餐"，窗口递出打包好的餐盒。没有菜单、没有服务员、没有等待。
= 直接发请求，拿到干净的数据，完事
克总本质上是一个程序，不是一个人。让克总走"堂食"路线，就像让一个看不见菜单的人帮你点菜——能做，但又慢又容易出错。让克总走"外卖窗口"（API），又快又稳。
为什么让克总操作网页不靠谱
网页是给人眼睛看的
克总看到的是一堆 HTML 代码，需要在里面找"搜索框在哪"、"按钮在哪"，就像在没有目录的书里找一句话。
网页随时会变
平台一更新界面，按钮位置变了，克总之前的操作方式就全废了。
验证码是拦路虎
很多网站会检测"你是不是机器人"。克总是机器人，它过不了这关。
速度慢还不稳定
操作网页需要等页面加载、等动画播放，批量处理 100 条数据光等待就够喝杯咖啡了。
一句话总结：让克总操作网页 = 让一个盲人帮你点外卖 App。能做，但很痛苦。
API 为什么好
直接拿到干净数据
API 返回结构化数据（JSON），就像整理好的 Excel 表格，克总直接能读懂。
稳定可重复
接口地址和参数格式不会轻易变。今天能用，下个月大概率还能用。
可以批量处理
查 100 个关键词热度？用网页一个个搜，用 API 几秒钟全查完。
没有验证码
API 用 Key 认证，不需要过验证码。Key 有效就能畅通无阻。
养成一个习惯：先找 API
当你有需求想让克总帮忙时，第一反应应该是："这个东西有没有 API？"
搜官方 API：Google 搜"产品名 + API"或"产品名 + 开放平台"
找第三方 API 服务：搜第三方数据服务（Pipiads、Kalodata 等）
看 SaaS 工具的 API：Notion、飞书、Airtable 都有 API
实在没有 API：再考虑爬虫或浏览器自动化（最后选择）
调用 API 的三件套
别只给克总一把钥匙。API Key 只是钥匙，克总还需要知道"门在哪"和"怎么开"。
API Key
钥匙：证明你有权限
API 文档
地图：接口地址、参数、返回格式
示例代码
参考答案：Quick Start 部分
| 你给克总的东西 | 效果 |
|---|---|
| 只给 API Key | ❌ 克总懵了 |
| Key + 文档 | ✅ 能搞定 |
| Key + 文档 + 示例代码 | ⚡ 秒搞定 |
给克总准备 API 调用时，记住：钥匙 + 地图 + 参考答案，三件套备齐再出发。