麦喵 API 批量导入工具

这是一个简单的 Python 脚本，帮助你将 Excel/CSV 词表批量导入到麦喵单词卡。

功能

• 自动登录麦喵账号
• 创建新卡组并批量导入词汇
• 支持正面/背面备注

环境要求

• Python 3.6+
• requests 库 (pip install requests)

快速开始

1. 准备 CSV 文件

创建一个 CSV 文件，格式如下：

front,back,front_note,back_note
Hello,你好,问候语,常用问候
World,世界,名词,地球、世界
Apple,苹果,水果,一种常见的水果

字段说明：

• front: 卡片正面内容（必填）
• back: 卡片背面内容（必填）
• front_note: 正面备注（可选）
• back_note: 背面备注（可选）

2. 运行导入脚本

python batch_import.py vocab.csv \
  --mobile "13800138000" \
  --password "your-password" \
  --title "英语四级词汇" \
  --description "大学英语四级核心词汇" \
  --tags "英语,四级,词汇" \
  --front-lang en \
  --back-lang zh

脚本会自动：

1. 登录你的麦喵账号
2. 创建新卡组
3. 批量导入 CSV 中的所有词汇

3. 参数说明

从 Excel 转换

如果你的词表是 Excel 格式，可以先用 Excel 另存为 CSV：

1. 在 Excel 中打开文件
2. 文件 → 另存为
3. 选择 CSV UTF-8 格式
4. 确保列名为：front, back, front_note, back_note

或者用 Python 转换：

import pandas as pd

# 读取 Excel
df = pd.read_excel('vocab.xlsx')

# 重命名列（根据你的实际列名调整）
df = df.rename(columns={
    '单词': 'front',
    '释义': 'back',
    '备注': 'front_note'
})

# 添加可选列（如果没有）
if 'back_note' not in df.columns:
    df['back_note'] = ''

# 保存为 CSV
df.to_csv('vocab.csv', index=False, encoding='utf-8')

常见问题

Q: 导入失败怎么办？

检查以下几点：

• CSV 文件编码是否为 UTF-8
• 必填字段（front, back）是否都有内容
• 手机号和密码是否正确
• 网络连接是否正常

Q: 可以导入多少张卡片？

目前没有硬性限制，但建议分批导入（每次 500 张以内），避免超时。

Q: 导入后在哪里查看？

导入完成后，卡组会出现在：

• 麦喵桌面端 → 我的卡组
• 微信小程序 → 我的 → 我的卡组

Q: 我想导入到已有卡组，而不是创建新卡组？

需要修改脚本源码：

1. 打开麦喵小程序 → 进入卡组 → 设置 → 复制 cardGroupToken
2. 编辑 batch_import.py，将 card_group_token 变量直接赋值为你的 Token
3. 注释掉创建卡组和获取 Token 的相关代码
4. 重新运行脚本

进阶用法

配合 AI 生成内容

你可以先用 AI 生成丰富的词汇内容，然后导出为 CSV 导入麦喵：

1. 给 AI 一个词表
2. 让 AI 生成带例句、同义词、词性的内容
3. 保存为 CSV
4. 用本工具导入

示例提示词：

请为以下单词生成详细的学习内容，格式化为 CSV：
单词列表：abandon, ability, absent

CSV 格式要求：
- front: 单词
- back: 中文释义
- front_note: 词性 + 英文例句
- back_note: 例句翻译

获取帮助

遇到问题？联系我们：

• 💬 微信公众号：磊子 X 麦喵单词卡
• 💬 微信：34805850（备注：API）