# tychxn/jd-assistant

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/tychxn-jd-assistant).**

5,266 stars · 1,868 forks · Python · MIT

## Links

- GitHub: https://github.com/tychxn/jd-assistant
- awesome-repositories: https://awesome-repositories.com/repository/tychxn-jd-assistant.md

## Topics

`assistant` `buy` `jd` `jingdong` `python3`

## Description

jd-assistant is an e-commerce automation bot designed for the JD.com platform. It functions as an automated checkout script and task runner that monitors product stock and executes purchase sequences for high-demand items.

The project specializes in flash sale automation, combining real-time stock monitoring with clock-synced task scheduling to trigger orders at specific timestamps. It manages the end-to-end purchase flow, including automated cart management and the submission of orders using predefined regional identifiers.

The system includes capabilities for account and session management via QR code authentication and cookie persistence. It further incorporates request randomization through user-agent rotation, RSA-based payload encryption for secure data transmission, and HTTP-based push notifications for execution alerts.

## Tags

### Business & Productivity Software

- [Order Placements](https://awesome-repositories.com/f/business-productivity-software/purchase-order-management/purchase-order-issuances/order-placements.md) — Automates the submission of orders from the cart using predefined addresses. ([source](https://github.com/tychxn/jd-assistant#readme))
- [Automated Checkout Tools](https://awesome-repositories.com/f/business-productivity-software/automated-checkout-tools.md) — Automates the final payment and order submission phase specifically for high-demand flash sales. ([source](https://github.com/tychxn/jd-assistant/wiki/1.-%E4%BA%AC%E4%B8%9C%E6%8A%A2%E8%B4%AD%E5%8A%A9%E6%89%8B%E7%94%A8%E6%B3%95))
- [E-Commerce Automations](https://awesome-repositories.com/f/business-productivity-software/e-commerce-automations.md) — Programmatically manages shopping carts and submits orders to bypass manual checkout steps.
- [E-commerce Product Data Extraction](https://awesome-repositories.com/f/business-productivity-software/e-commerce-product-data-extraction.md) — Extracts real-time pricing, stock levels, and address mappings from retail product pages. ([source](https://github.com/tychxn/jd-assistant/blob/master/README.md))
- [End-to-End Order Workflows](https://awesome-repositories.com/f/business-productivity-software/end-to-end-order-workflows.md) — Orchestrates the entire purchase sequence from account login and stock monitoring to final order execution. ([source](https://github.com/tychxn/jd-assistant/search))
- [Flash Sale Automations](https://awesome-repositories.com/f/business-productivity-software/high-concurrency-sales-systems/flash-sale-automations.md) — Secures high-demand products by monitoring stock and automating the checkout process during flash sales.
- [Shopping Carts](https://awesome-repositories.com/f/business-productivity-software/shopping-carts.md) — Provides logic for adding items to the shopping cart and managing staged products. ([source](https://github.com/tychxn/jd-assistant#readme))
- [Web Task Automations](https://awesome-repositories.com/f/business-productivity-software/web-task-automations.md) — Automates repetitive browser-based workflows and site interactions using web scraping and cryptography. ([source](https://github.com/tychxn/jd-assistant/blob/master/requirements.txt))
- [Account and Order Monitoring](https://awesome-repositories.com/f/business-productivity-software/e-commerce-integrations/order-retrieval/account-and-order-monitoring.md) — Retrieves user account information and filters for unpaid orders to manage the checkout process. ([source](https://github.com/tychxn/jd-assistant#readme))

### System Administration & Monitoring

- [Stock Availability Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/stock-availability-monitoring.md) — Continuously polls product endpoints at high frequency to detect item availability for immediate purchase.
- [Task Schedulers](https://awesome-repositories.com/f/system-administration-monitoring/task-schedulers.md) — Triggers purchasing sequences based on precise dates, times, or detected stock availability.

### Development Tools & Productivity

- [Task Scheduling](https://awesome-repositories.com/f/development-tools-productivity/task-scheduling.md) — Implements a time-based trigger to initiate purchase sequences at precise target timestamps.

### Security & Cryptography

- [HTTP Cookie Persistence](https://awesome-repositories.com/f/security-cryptography/session-persistence-strategies/client-session-persistence/download-session-persistence/http-cookie-persistence.md) — Stores and retrieves HTTP cookies from local files to maintain authenticated sessions across multiple runs.
- [Persistent Session Managers](https://awesome-repositories.com/f/security-cryptography/user-account-management/persistent-session-managers.md) — Manages the persistence of authentication tokens and session data to enable automated multi-account control. ([source](https://github.com/tychxn/jd-assistant#readme))
- [Payload Encryption](https://awesome-repositories.com/f/security-cryptography/asymmetric-signing/rsa-signing-implementations/payload-encryption.md) — Encrypts sensitive request parameters using an RSA public key to ensure secure data transmission. ([source](https://github.com/tychxn/jd-assistant/blob/master/util.py))
- [Payload Encryptions](https://awesome-repositories.com/f/security-cryptography/encryption-key-files/payload-encryptions.md) — Encrypts request parameters using RSA public keys to secure sensitive data transmitted to the platform.
- [QR-Code Handshakes](https://awesome-repositories.com/f/security-cryptography/user-authentication-flows/qr-code-handshakes.md) — Provides an authentication flow using QR code scanning to establish a secure session for automated actions. ([source](https://github.com/tychxn/jd-assistant/blob/master/main.py))

### Data & Databases

- [Automated Web Scraping](https://awesome-repositories.com/f/data-databases/automated-web-scraping.md) — Automatically extracts real-time pricing and availability data from retail product pages.

### DevOps & Infrastructure

- [Delayed Task Scheduling](https://awesome-repositories.com/f/devops-infrastructure/automation-orchestration/task-execution-frameworks/task-job-management/task-schedulers/delayed-task-scheduling.md) — Triggers purchase sequences at specific timestamps by polling the system clock. ([source](https://github.com/tychxn/jd-assistant/blob/master/timer.py))

### Networking & Communication

- [User Agent Rotation](https://awesome-repositories.com/f/networking-communication/user-agent-rotation.md) — Rotates browser identification strings for each request to mimic different clients and evade bot detection.

### Web Development

- [Session and Cookie Automators](https://awesome-repositories.com/f/web-development/http-cookie-managers/session-and-cookie-automators.md) — Manages user sessions and cookies to perform authenticated API calls for order placement.
