API 文档

欢迎使用微采API！本文档将帮助您快速集成我们的数据采集服务。

快速开始

只需三步，即可开始使用微采API采集微信公众号数据。

安装

使用 pip 安装 Python SDK：

pip install weicai-sdk

或者使用 npm 安装 Node.js SDK：

npm install weicai-sdk

认证

所有API请求都需要使用API Key和API Secret进行认证。您可以在控制台获取密钥。

from weicai import ApiClient

# 初始化客户端
client = ApiClient(
    api_key='YOUR_API_KEY',
    api_secret='YOUR_API_SECRET'
)

API 参考

获取最新文章

获取指定公众号的最新文章列表

client.get_latest_articles(nickname, count=10)

参数

nickname公众号ID（必填）
count文章数量，默认10（可选）

返回值

[
  {
    "title": "文章标题",
    "url": "https://mp.weixin.qq.com/s/...",
    "author": "作者",
    "publish_time": "2025-10-31 12:00:00",
    "cover_url": "封面图片URL"
  },
  ...
]

关键词搜索

在公众号文章中搜索关键词

client.keyword_search(keyword, nickname, count=10, search_type='title')

参数

keyword搜索关键词（必填）
nickname公众号ID（必填）
count返回结果数量，默认10（可选）
search_type'title' 或 'content'，默认'title'（可选）

提取Markdown

从文章URL提取Markdown格式内容

client.extract_markdown_from_article(url)

参数

url文章URL（必填）

返回值

# 文章标题

文章内容...

## 小标题

更多内容...

代码示例

Python 示例

from weicai import ApiClient

# 初始化客户端
client = ApiClient('YOUR_API_KEY', 'YOUR_API_SECRET')

# 采集公众号最新文章
articles = client.get_latest_articles(
    nickname='公众号ID',
    count=10
)

for article in articles:
    print(f"标题: {article['title']}")
    print(f"链接: {article['url']}")
    print(f"发布时间: {article['publish_time']}")
    print("-" * 50)

# 关键词搜索
search_results = client.keyword_search(
    keyword='科技创新',
    nickname='公众号ID',
    count=5,
    search_type='content'
)

# 提取Markdown格式
markdown = client.extract_markdown_from_article(
    articles[0]['url']
)
print(markdown)

# 保存到文件
with open('article.md', 'w', encoding='utf-8') as f:
    f.write(markdown)

Node.js 示例

const { ApiClient } = require('weicai-sdk');

// 初始化客户端
const client = new ApiClient({
  apiKey: 'YOUR_API_KEY',
  apiSecret: 'YOUR_API_SECRET'
});

// 采集公众号最新文章
async function fetchArticles() {
  const articles = await client.getLatestArticles({
    nickname: '公众号ID',
    count: 10
  });

  articles.forEach(article => {
    console.log(`标题: ${article.title}`);
    console.log(`链接: ${article.url}`);
  });

  // 提取Markdown
  const markdown = await client.extractMarkdown(articles[0].url);
  console.log(markdown);
}

fetchArticles();

错误处理

API可能返回以下错误代码：

状态码	说明
200	请求成功
400	请求参数错误
401	认证失败
429	请求次数超限
500	服务器错误

try:
    articles = client.get_latest_articles('公众号ID')
except Exception as e:
    print(f"错误: {e}")
    # 处理错误

需要帮助？

如果您在使用过程中遇到任何问题，欢迎联系我们：

📧 邮箱：support@weicai.pro
💬 在线客服：访问官网右下角
📖 更多文档：weicai.pro