youxiang: 获取淘宝优惠券、京东优惠券、拼多多（多多客）优惠券、苏宁易购优惠券，通过接入淘宝联盟、京东联盟、拼多多（多多进宝）、苏宁联盟（苏宁推客）及其对应的开放平台，获取优惠商品图片和对应商品信息，利用微信机器人推送到指定群聊。

[![Python 3.7](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/release/python-370/)
 [![itchat_vesion](https://img.shields.io/badge/Itchat-1.3.10-brightgreen.svg)](https://github.com/littlecodersh/ItChat)
 [![EverydayWechat](https://img.shields.io/badge/sfyc23/Powered%20By-EverydayWechat-brightgreen.svg)](https://github.com/sfyc23/EverydayWechat/)
 [![GitHub issues](https://img.shields.io/github/issues/why2lyj/youxiang.svg)](https://github.com/why2lyj/youxiang/issues)
 
 
## 项目背景

无非就是想撸羊毛，自己又懒的一个一个找，一个一个发。已知目前的返佣app非常的多，比如：好省，蜜源，粉象，芬香等等等等。归根到底无非是利用淘宝、京东、拼多多、苏宁的开放平台做的。所以想到是否可以利用已有的开放平台来做一个属于自己的撸羊毛项目。

其实说白了就是 ：
1. 建立微信群 
2. 向微信群里发送自己的推广链接和商品图片
3. 剩下的尽人事听天命了

## 功能说明

项目主要参考 [EverydayWechat](https://github.com/sfyc23/EverydayWechat)

-  支持对多个微信好友自动回复。  （保留原[EverydayWechat](https://github.com/sfyc23/EverydayWechat)功能，自动回复仅保留**智能闲聊（腾讯）**）
-  群助手功能，仅保留进群自动回复及@时自动回复功能。
-  淘宝优惠券自动分发。 
   > 创建定时任务，通过api获取淘宝推广客的优惠信息，发送到群聊。
-  京东优惠券自动分发。
   > 创建定时任务，通过api获取京东联盟的优惠信息，发送到群聊。
-  拼多多优惠券自动分发。
   > 创建定时任务，通过api获取多多进宝（多宝客）的优惠信息，发送到群聊。
-  苏宁易购优惠券自动分发。
   > 创建定时任务，通过官方sdk获取苏宁联盟（苏宁推客）的优惠信息，发送到群聊。

## 配置信息

仅介绍**推广客设置**，其余配置请参考[EverydayWechat](https://github.com/sfyc23/EverydayWechat)，不做多余赘述。

参数说明：

淘宝联盟

| 名称 | 示例       | 必填 | 说明 |
| -------- | -------------- | ---------- |---------- |
| is_open | True/False | 必填 | 是否开启淘宝联盟推广|
| app_key | 淘宝联盟 app_key | 必填 | 淘宝联盟申请下来的 app_key |
| app_secret | 淘宝联盟 app_secret | 必填 | 淘宝联盟申请下来的 app_secret |
| adzone_id | 淘宝联盟广告位 | 必填 | 淘宝联盟推广中的广告位 |
| chat_groups |  | 必填 | 详情见举例 |
| group_name | 群名称 | 必填 | 对应微信群的群名称 |
| group_material_id | 物料id | 必填 | 淘宝联盟[material_id](https://market.m.taobao.com/app/qn/toutiao-new/index-pc.html#/detail/10628875?_k=gpov9a)|
| minute | 分钟 | 必填 | 定时任务对应的分钟，逗号分隔，注意空格 |
| hour | 小时 | 必填 | 定时任务对应的小时，逗号分隔，注意空格 |

京东联盟

| 名称 | 示例       | 必填 | 说明 |
| -------- | -------------- | ---------- |---------- |
| is_open | True/False | 必填 | 是否开启京东联盟推广|
| app_key | 京东联盟 app_key | 必填 | 京东联盟申请下来的 app_key |
| app_secret | 京东联盟 app_secret | 必填 | 京东联盟申请下来的 app_secret |
| site_id | 京东联盟网站id或app id | 必填 | 京东联网站id或app id |
| chat_groups |  | 必填 | 详情见举例 |
| group_name | 群名称 | 必填 | 对应微信群的群名称 |
| group_material_id | 物料id | 必填 | 京东联盟物料id|
| minute | 分钟 | 必填 | 定时任务对应的分钟，逗号分隔，注意空格 |
| hour | 小时 | 必填 | 定时任务对应的小时，逗号分隔，注意空格 |

拼多多（多多进宝、多多客）

| 名称 | 示例       | 必填 | 说明 |
| -------- | -------------- | ---------- |---------- |
| is_open | True/False | 必填 | 是否开启拼多多推广|
| app_key | 拼多多 Client_id | 必填 | 拼多多申请下来的 Client_id |
| app_secret | 拼多多 Client_secret | 必填 | 拼多多申请下来的 Client_secret |
| site_id | 推广位 | 必填 | 利用拼多多[接口](https://open.pinduoduo.com/application/document/apiTools?scopeName=pdd.ddk.goods.pid.generate&catId=12)得到的推广位`pid` |
| chat_groups |  | 必填 | 详情见举例 |
| group_name | 群名称 | 必填 | 对应微信群的群名称 |
| group_material_id | 栏目 | 非必填 | 保留字段，底层无用|
| minute | 分钟 | 必填 | 定时任务对应的分钟，逗号分隔，注意空格 |
| hour | 小时 | 必填 | 定时任务对应的小时，逗号分隔，注意空格 |

苏宁易购（苏宁推客）

| 名称 | 示例       | 必填 | 说明 |
| -------- | -------------- | ---------- |---------- |
| is_open | True/False | 必填 | 是否开启苏宁推广|
| app_key | 苏宁易购 appKey | 必填 | 苏宁易购开放平台新建应用的 appKey |
| app_secret | 苏宁易购 secretKey | 必填 | 苏宁易购开放平台新建应用的 secretKey |
| ad_book_id | 推广位 | 必填 | 利用苏宁联盟得到的推广位 |
| chat_groups |  | 必填 | 详情见举例 |
| group_name | 群名称 | 必填 | 对应微信群的群名称 |
| group_material_id | 栏目 | 非必填 | 保留字段，底层无用|
| minute | 分钟 | 必填 | 定时任务对应的分钟，逗号分隔，注意空格 |
| hour | 小时 | 必填 | 定时任务对应的小时，逗号分隔，注意空格 |

**”实例1**，每天7点到23点，每小时的第10分，第40分，将淘宝物料id:19810，发送至群聊 <口碑KFC必胜客麦当劳优惠券>：
> {group_name: '口碑KFC必胜客麦当劳优惠券', group_material_id: '19810', minute: '10,40', hour: '7-23'}

**实例2**，每天7点，12点，15点的第30分，将淘宝物料id:3767,27448,13367,3788的优惠券，发送至群聊 <淘宝内部优惠群-女装类①> ：
> {group_name: '淘宝内部优惠群-女装类①', group_material_id: '3767,27448,13367,3788', minute: '30', hour: '9,12,15'}

*提示* 在运行程序前确保群名已经有且已经保存到通讯录

## 前提准备

---
申请淘宝联盟api：
[申请地址](https://pub.alimama.com/?spm=a219t.7664554.a214tr8.19.2f5835d9zBLGBR)
[文档参考](https://open.taobao.com/doc.htm?docId=73&docType=1)

努力看文档操作，获取到 `App Key` 和 `App Secret`，同时利用商品推广得到 广告位 `adzone_id`

---
申请京东联盟api：
[申请地址](https://union.jd.com/)
[文档参考](https://union.jd.com/helpcenter/13246-13247-46301)

要使用京东联盟获取推广优惠券需要有siteId(站点ID是指在联盟后台的推广管理中的网站Id、APPID)，此申请需要网站备案或有实际app。如没有尽早申请。

另外由于京东联盟生成短址的接口需要申请，申请资质要求（[参考](https://union.jd.com/helpcenter/13246-13247-46301)）目前非力所能及，故采用[suo.mi](http://suo.im/)转换短址，区别如下：

| 名称 | 短址示例       | 说明 |
| -------- | -------------- | ---------- |
| 京东短址 | [http://u.jd.com/XXXX](https://github.com/why2lyj/youxiang) | api申请门槛高|
| 京东短址 | [http://suo.mi/XXXX](https://github.com/why2lyj/youxiang) | 门槛低，免费|

*关于短址：建议选择微信或腾讯的短址服务进行转换以免被屏，没用的另外原因是没有相关token，其他网络上的api没有遇到合适的。*

---
申请苏宁易购api:

[苏宁联盟开放平台API接入操作指导2.7-20200526.pdf](images/苏宁联盟开放平台API接入操作指导2.7.pdf)

--- 
申请拼多多(多多客)api：

首先去拼多多开放平台申请一个应用 [申请地址](https://open.pinduoduo.com/)，得到`Client_id`和`Client_secret`，然后去多多进宝绑定`Client_id`后可以调用接口[接口文档](https://jinbao.pinduoduo.com/third-party/rank)，利用接口得到推广位`pid`

*拼多多接口每天调用仅5000次*

## 快速启动

直接下载此项目或 clone 项目到本地。

使用 pip 安装依赖:

```
pip3 install -r requirements.txt
# 或者是使用 pip
# pip install -r requirements.txt
```
运行：
```python
python main.py
```

扫码后，即可使用。

如果你想使用docker启动（请确保`_config.yaml`文件已改成指定）

1. 首先创建镜像，运行
   ```shell
   docker build -f Dockerfile -t youxiang:v1.0.0
   ```
   
2. 启动容器，运行
   ```shell
   docker run -it -d --name youxiang youxiang:1.0.0
   ```
3. 运行以下脚本获取二维码，然后微信登陆
   ```shell
   docker logs -f --tail=1000 youxiang
   ```

如果你不想每次都进容器改`_config.yaml`在第2步的时候可以将项目目录映射到本地
  ```shell
  docker run -it -d -v $pwd:/youxiang --name youxiang youxiang:1.0.0
  ```
## 示例截图：
---
淘宝：

![发送淘宝优惠信息](https://github.com/why2lyj/youxiang/blob/master/images/yangli.jpg?raw=true)

---
京东：

![发送京东优惠信息](https://github.com/why2lyj/youxiang/blob/master/images/jdyangli.jpg?raw=true)

---
拼多多：

![发送拼多多优惠信息](https://github.com/why2lyj/youxiang/blob/master/images/pddyangli.jpg?raw=true)

---
苏宁易购：

![发送苏宁优惠信息](https://github.com/why2lyj/youxiang/blob/master/images/suningyangli.jpg?raw=true)

## 声明

**禁止将本工具用于商业用途**，如产生法律纠纷与本人无关。

## Credits 致谢

本项目受以下项目或文章启发，参考了其中一部分思路，向这些开发者表示感谢。  
- [EverydayWechat](https://github.com/sfyc23/EverydayWechat)
- [python 淘宝OPEN API 调用示例](https://www.jianshu.com/p/f9b5e3020789)

jiacunhe/youxiang

简介

发行版

贡献者

近期动态

jiacunhe/youxiang .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

jiacunhe/youxiang