LangChain (TypeScript)

​

Features

• Web scraping – scrape any URL and retrieve Markdown content
• Google Search – search Google and retrieve structured results
• Amazon Search – search Amazon and retrieve structured product data
• Full TypeScript support – complete type definitions for all parameters
• LangChain integration – seamless integration with LangChain’s tool system

​

Quick start

​

Prerequisites

• Node.js >= v20
• A Decodo Web Data API subscription

npm install @decodo/langchain-ts

1. Clone the repo and install dependencies

git clone [email protected]:Decodo/decodo-langchain-ts.git
cd decodo-langchain-ts
npm i

2. Copy .env.example to .env and fill in SCRAPER_API_KEY. On an older plan, fill in SCRAPER_API_USERNAME and SCRAPER_API_PASSWORD instead. The examples also read OPENAI_API_KEY.

cp .env.example .env

3. Run any of the sample agents

npm run example:agent-universal
npm run example:agent-google
npm run example:agent-amazon

import dotenv from 'dotenv';
import { ChatOpenAI } from '@langchain/openai';
import { createReactAgent } from '@langchain/langgraph/prebuilt';
import { DecodoUniversalTool } from '@decodo/langchain-ts';

dotenv.config();

const main = async () => {
  const decodoUniversalTool = new DecodoUniversalTool({
    apiKey: process.env.SCRAPER_API_KEY,
  });

  const model = new ChatOpenAI({
    model: 'gpt-5-mini',
  });

  const agent = createReactAgent({
    llm: model,
    tools: [decodoUniversalTool],
  });

  const result = await agent.invoke({
    messages: [
      {
        role: 'user',
        content: 'scrape the wikipedia NBA 2025 season page and tell me who won in 2025?',
      },
    ],
  });

  console.log(result.messages[result.messages.length - 1].content);
};

main();

​

Available tools

​

Configuration

type DecodoConfig =
  | {
      apiKey: string; // Your Web Data API key
    }
  | {
      username: string; // Your Web Advanced product username
      password: string; // Your Web Advanced product password
    };

const tool = new DecodoUniversalTool({ apiKey: process.env.SCRAPER_API_KEY });

// or, on an older plan

const tool = new DecodoUniversalTool({
  username: process.env.SCRAPER_API_USERNAME,
  password: process.env.SCRAPER_API_PASSWORD,
});

​

Parameters

​

Values fixed by each tool

​

Related

• TypeScript SDK – The SDK these tools are built on.
• LangChain (Python) – The Python LangChain package.
• MCP Server – Connect AI agents and MCP-compatible tools to Decodo.
• CLI – Run Decodo scraping workflows from the command line.
• GitHub repository – View the source code, examples, and latest releases.