tiktok_shop_product

Instructions

Implementation Reference

• src/tools/tiktok-shop-product/tiktok-shop-product-tool.ts:31-50 (handler)

  The handler function (lines 31-48) that executes the tool logic: it takes scraping params, sets the target to TIKTOK_SHOP_PRODUCT, calls sapiClient.scrape(), and returns the data as text content.

      async (scrapingParams: ScrapingMCPParams, extra: ProgressExtra) => {
        const params = {
          ...scrapingParams,
          target: SCRAPER_API_TARGETS.TIKTOK_SHOP_PRODUCT,
          markdown: true,
        } satisfies ScraperAPIParams;
  
        const { data } = await sapiClient.scrape<object>({ auth, scrapingParams: params, extra });
  
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify(data),
            },
          ],
        };
      }
    );
  };

• src/tools/tiktok-shop-product/tiktok-shop-product-tool.ts:20-25 (schema)

  Input schema definition for the tool, accepting product_id (string), jsRender, deviceType, and country.

  inputSchema: {
    product_id: z.string().describe('TikTok Shop product ID (e.g., "1731541214379741272")'),
    jsRender: zodJsRender,
    deviceType: zodDeviceType,
    country: zodCountry,
  },

• src/tools/tiktok-shop-product/tiktok-shop-product-tool.ts:15-49 (registration)

  Registration of the tool named 'tiktok_shop_product' on the MCP server via server.registerTool().

  register = ({ server, sapiClient, auth }: ToolRegistrationArgs) => {
    server.registerTool(
      'tiktok_shop_product',
      {
        description: 'Scrape TikTok Shop Product page',
        inputSchema: {
          product_id: z.string().describe('TikTok Shop product ID (e.g., "1731541214379741272")'),
          jsRender: zodJsRender,
          deviceType: zodDeviceType,
          country: zodCountry,
        },
        annotations: {
          readOnlyHint: true,
          openWorldHint: true,
        },
      },
      async (scrapingParams: ScrapingMCPParams, extra: ProgressExtra) => {
        const params = {
          ...scrapingParams,
          target: SCRAPER_API_TARGETS.TIKTOK_SHOP_PRODUCT,
          markdown: true,
        } satisfies ScraperAPIParams;
  
        const { data } = await sapiClient.scrape<object>({ auth, scrapingParams: params, extra });
  
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify(data),
            },
          ],
        };
      }
    );

• src/server/sapi-base-server.ts:85-85 (registration)

  Tool instantiation (new TiktokShopProductTool()) in the allTools static array, which is later iterated over to register all tools.

  new TiktokShopProductTool(),

• src/constants.ts:31-31 (helper)

  Constant definition SCRAPER_API_TARGETS.TIKTOK_SHOP_PRODUCT = 'tiktok_shop_product' used to set the API target.

  TIKTOK_SHOP_PRODUCT = 'tiktok_shop_product',