Rastreamento de Preços do TikTok Shop com Capturas de Tela de Produtos em Python

TL;DR:

• O rastreamento de preços é um pipeline de instantâneos. Chame scraper.tiktok.shop.page em uma programação, registre cada resposta com um carimbo de data/hora e compare semelhante com semelhante.
• A chave de comparação inclui o contexto do mercado. A ID do produto, a região retornada, a moeda e a identidade SKU evitam correspondências falsas.
• Mudanças em produtos e SKUs são eventos diferentes. Rastreie o preço do produto exibido e o estoque separadamente da disponibilidade ou preço da variante.
• Faltando não é zero. Um campo ausente não deve acionar um alerta de estoque esgotado ou preço livre.
• O ator não cria histórico ou alertas. O armazenamento SQLite, as regras de comparação, a programação e a entrega vivem na aplicação que chama.
• Grátis para começar. Novas contas Scrapeless incluem crédito gratuito através do Painel Scrapeless.

Introdução: um rastreador é mais do que um pedido repetido

Uma única resposta de produto da TikTok Shop responde ao que a página expõe agora. Um rastreador de preços responde a uma pergunta diferente: o que mudou entre duas observações comparáveis e a mudança é significativa o suficiente para notificar alguém?

Essa distinção afeta todo o design. O ator do Scrapeless Shop fornece instantâneas estruturadas do produto. A aplicação adiciona um carimbo de data/hora, armazena linhas de produto e SKU, compara cada linha com sua observação anterior e emite um evento pronto para alerta. Este guia constrói esse pipeline com Python e SQLite.

Para o padrão de solicitação por trás das instantâneas de produtos, leia o guia de ator de dados Scrapeless ao vivo.

Pipeline em um Relance

Este pipeline monitora uma lista de produtos fornecida pela aplicação. Não descobre todos os produtos em uma loja nem expõe um livro de pedidos privado.

Pré-requisitos

• Uma conta Scrapeless e token de API do Painel Scrapeless
• Python com a biblioteca padrão e suporte a SQLite
• IDs de produtos conhecidos da TikTok Shop
• Uma regra de região para cada produto
• Uma política de alerta que define quais mudanças importam

O código requer um token ao vivo em SCRAPELESS_API_KEY. A lista de produtos é fornecida pela sua aplicação.

Estágio 1 — Obter um Instantâneo do Produto

Chame POST https://api.scrapeless.com/api/v1/scraper/request com o ator scraper.tiktok.shop.page. Sua entrada contém product_id como uma string e region. A documentação do ator da página TikTok Shop mostra os campos de solicitação e resposta.

O resultado pode incluir identidade do produto, região retornada, vendedor, nome, contagem de vendas, preço, moeda, estoque, classificação, contagem de avaliações, imagens, opções, SKUs, categorias, e detalhes de envio. Armazene a resposta bruta antes da normalização para que mudanças de esquema posteriores possam ser tratadas sem recolher a mesma observação.

Estágio 2 — Normalizar Linhas de Produto e SKU

Use uma chave de produto feita a partir da ID do produto e da região retornada. Para variantes, adicione o identificador SKU. A moeda pertence ao registro de comparação; um preço numérico não tem significado seguro no mercado cruzado por conta própria.

O referência de código de moeda ISO explica o papel dos identificadores de moeda. Mantenha o valor de origem, mesmo quando uma camada de relatório a montante também converte preços.

O inventário de produtos e variantes deve permanecer separado. A documentação de inventário da TikTok Shop trata identificadores de produtos e SKUs como dimensões de consulta distintas, o que corresponde a um esquema de instantâneo limpo.

Comece a Raspagem com Scrapeless

Potencialize seu fluxo de trabalho de raspagem da web e automação com Scrapeless!
Inscreva-se hoje e receba $5 em crédito gratuito — sem necessidade de cartão de crédito.

Reclame seu crédito gratuito agora no Painel Scrapeless.

Estágio 3 — Armazenar Instantâneas no SQLite

SQLite funciona bem para um monitor pequeno porque o banco de dados e as funções de tempo estão disponíveis no Python sem um serviço separado. A documentação do CREATE TABLE SQLite define as restrições da tabela usadas no esquema.

import json
import os
import sqlite3
from datetime import datetime, timezone
from urllib.request import Request, urlopen

ENDPOINT = "https://api.scrapeless.com/api/v1/scraper/request"


def fetch_product(product_id, region):
    body = json.dumps({
        "actor": "scraper.tiktok.shop.page",
        "input": {"product_id": str(product_id), "region": region},
    }).encode()
    request = Request(
        ENDPOINT,
        data=body,
        headers={
            "x-api-token": os.environ["SCRAPELESS_API_KEY"],
            "content-type": "application/json",
        },
        method="POST",
    )
    with urlopen(request, timeout=60) as response:
        return json.load(response)


def open_database(path="tiktok_shop_history.sqlite3"):
    database = sqlite3.connect(path)
    database.execute("""
        CREATE TABLE IF NOT EXISTS product_snapshots (
            observed_at TEXT NOT NULL,
            product_id TEXT NOT NULL,
            region TEXT NOT NULL,
            currency TEXT,
            price TEXT,
            stock INTEGER,
            sold_count INTEGER,
            raw_json TEXT NOT NULL,
            PRIMARY KEY (observed_at, product_id, region)
        )
    """)
    return database


def store_product(database, raw):
    observed_at = datetime.now(timezone.utc).isoformat()
    row = (
        observed_at,
        str(raw.get("product_id", "")),
        str(raw.get("region", "")),
        raw.get("currency"),
        None if raw.get("price") is None else str(raw.get("price")),
        raw.get("stock"),
        raw.get("sold_count"),
        json.dumps(raw, ensure_ascii=False),
    )
    database.execute(
        "INSERT INTO product_snapshots VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
        row,
    )
    database.commit()
    return row

Armazene o preço como texto fonte ou um tipo decimal exato em sistemas que o suportam. Ponto flutuante binário é uma escolha de armazenamento ruim para dinheiro porque alguns valores decimais não podem ser representados exatamente.

Etapa 4 — Comparar com a Observação Anterior

A comparação deve ocorrer apenas dentro do mesmo ID de produto, região retornada e moeda. Consulte a linha anterior mais recente, depois produza um evento para campos que estão presentes em ambas as observações.

from decimal import Decimal


def previous_snapshot(database, product_id, region, observed_at):
    return database.execute(
        """
        SELECT observed_at, currency, price, stock
        FROM product_snapshots
        WHERE product_id = ? AND region = ? AND observed_at < ?
        ORDER BY observed_at DESC
        LIMIT 1
        """,
        (str(product_id), region, observed_at),
    ).fetchone()


def compare(current, previous):
    if previous is None:
        return {"state": "baseline", "changes": []}

    _, old_currency, old_price, old_stock = previous
    changes = []
    if current[3] == old_currency and current[4] is not None and old_price is not None:
        new_price = Decimal(current[4])
        prior_price = Decimal(old_price)
        if new_price != prior_price:
            changes.append({
                "field": "price",
                "before": str(prior_price),
                "after": str(new_price),
                "currency": current[3],
            })
    if current[5] is not None and old_stock is not None and current[5] != old_stock:
        changes.append({"field": "stock", "before": old_stock, "after": current[5]})
    return {"state": "compared", "changes": changes}


database = open_database()
raw = fetch_product(os.environ["TIKTOK_SHOP_PRODUCT_ID"], "GB")
current = store_product(database, raw)
prior = previous_snapshot(database, current[1], current[2], current[0])
print(json.dumps(compare(current, prior), indent=2))

A primeira observação estabelece uma linha de base e não deve produzir um alerta de mudança de preço. Um valor ausente também não deve se tornar zero ou um evento de item fora de estoque.

Etapa 5 — Acompanhar Mudanças no SKU

Crie uma segunda tabela de histórico indexada pelo tempo de observação, ID do produto, região retornada e ID do SKU. Armazene os rótulos de opção, preço do SKU quando exposto, moeda e disponibilidade. Compare um SKU apenas com sua própria linha anterior.

Listas de variantes podem mudar. Um SKU recém-observado é um evento de descoberta; um SKU ausente é uma ausência que precisa de confirmação sob a política de coleção da aplicação. Não declare uma variante descontinuada a partir de uma resposta ausente.

Etapa 6 — Produzir Eventos Prontos para Alerta

Mantenha a coleta separada da notificação. O trabalho de comparação pode gravar eventos como:

• preço do produto mudou na mesma moeda e região
• estoque agregado ultrapassou um limite de negócios
• a disponibilidade de um SKU conhecido mudou
• um novo SKU apareceu

Aplique limites após as mudanças exatas serem calculadas. Inclua os tempos de observação anterior e atual, ID do produto, região, moeda, campo e valores antes/depois. Um trabalhador downstream pode direcionar o evento para e-mail, chat, um webhook ou um painel interno.

Leia sold_count Cuidadosamente

Preserve sold_count conforme retornado com a captura do produto. Ele não identifica uma janela de relatório, pedidos individuais, reembolsos ou GMV. Uma mudança entre observações é uma alteração de rótulo da página, não um livro de vendas completo.

Scrapeless fornece o ator do produto através da API de Scraping. Use a página de preços atual para estimar o custo do conjunto de produtos e o cronograma escolhido.

Conclusão: mantenha as capturas comparáveis

O rastreamento de preços do TikTok Shop precisa de uma chave estável, um timestamp de coleta, histórico de produto e SKU separado, e regras de mudança cautelosas. O ator fornece cada captura pública do produto; o trabalho em Python circundante transforma essas observações em um histórico e eventos prontos para alerta.

Pronto para Construir Seu Monitor de Preços?

Junte-se ao Discord do Scrapeless ou à comunidade do Telegram para discutir esquemas de monitoramento. Crie uma conta no Painel do Scrapeless quando a lista de produtos e a política de alertas estiverem prontas.

FAQ

Q: O Scrapeless fornece histórico automático de preços do TikTok Shop?

Não. O ator retorna capturas de produtos; a aplicação que faz a chamada agenda solicitações, armazena observações, compara linhas e entrega alertas.

Q: Que chave um rastreador de preços do TikTok Shop deve usar?

Use o ID do produto mais a região retornada para registros de produtos e adicione o ID do SKU para registros de variantes. Mantenha a moeda em cada comparação de preço.

Q: Um valor de preço ou estoque ausente deve ser armazenado como zero?

Não. Ausente significa desconhecido, enquanto zero é um valor definitivo com um significado de negócio diferente.

Q: A contagem de vendidos pode ser usada como vendas diárias ou GMV?

Não. O rótulo retornado não estabelece uma janela de relatório nem fornece um livro de pedidos e receita completo.

Q: Com que frequência o rastreador deve ser executado?

Escolha uma cadência com base na decisão de negócios, volatilidade do produto, uso permitido e orçamento. Registre o cronograma para que lacunas na história permaneçam visíveis.

Q: Monitorar preços públicos de lojas é legal?

A legalidade depende da jurisdição, mercado, propósito, método de acesso e termos aplicáveis. Monitore dados de produtos públicos para um propósito permitido e obtenha aconselhamento jurídico para o uso pretendido.

Q: Eu preciso gerenciar proxies, defesas de página ou seletores DOM?

Scrapeless lida com a superfície de coleta. A aplicação gerencia a lista de produtos, timestamps, armazenamento, comparações e notificações.

Q: Isso pode correr sem um agente de IA?

Sim. O fluxo de trabalho usa solicitações HTTP diretas, SQLite e código Python comum.