@fugle/node-twstock 2.2.1-alpha.0

package/lib/scrapers/isin-scraper.d.ts

@@ -0,0 +1,13 @@
+import { Scraper } from './scraper';
+import { FutOpt, Stock } from '../interfaces';
+export declare class IsinScraper extends Scraper {
+    fetchListed(options: {
+        symbol: string;
+    }): Promise<Stock[]>;
+    fetchListedStocks(options: {
+        exchange: 'TWSE' | 'TPEx';
+    }): Promise<Stock[]>;
+    fetchListedFutOpt(options?: {
+        type?: 'F' | 'O';
+    }): Promise<FutOpt[]>;
+}

package/lib/scrapers/isin-scraper.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsinScraper = void 0;
+const cheerio = require("cheerio");
+const iconv = require("iconv-lite");
+const luxon_1 = require("luxon");
+const scraper_1 = require("./scraper");
+const utils_1 = require("../utils");
+class IsinScraper extends scraper_1.Scraper {
+    async fetchListed(options) {
+        const { symbol } = options;
+        const url = `https://isin.twse.com.tw/isin/single_main.jsp?owncode=${symbol}`;
+        const response = await this.httpService.get(url, { responseType: 'arraybuffer' });
+        const page = iconv.decode(response.data, 'big5');
+        const $ = cheerio.load(page);
+        const data = $('.h4 tr').slice(1).map((_, el) => {
+            const td = $(el).find('td');
+            return {
+                symbol: td.eq(2).text().trim(),
+                name: td.eq(3).text().trim(),
+                exchange: (0, utils_1.asExchange)(td.eq(4).text().trim()),
+                type: td.eq(5).text().trim(),
+                industry: (0, utils_1.asIndustry)(td.eq(6).text().trim()),
+                listedDate: luxon_1.DateTime.fromFormat(td.eq(7).text().trim(), 'yyyy/MM/dd').toISODate(),
+            };
+        }).toArray();
+        return data;
+    }
+    async fetchListedStocks(options) {
+        const { exchange } = options;
+        const url = {
+            'TWSE': 'https://isin.twse.com.tw/isin/class_main.jsp?market=1',
+            'TPEx': 'https://isin.twse.com.tw/isin/class_main.jsp?market=2',
+        };
+        const response = await this.httpService.get(url[exchange], { responseType: 'arraybuffer' });
+        const page = iconv.decode(response.data, 'big5');
+        const $ = cheerio.load(page);
+        const data = $('.h4 tr').slice(1).map((_, el) => {
+            const td = $(el).find('td');
+            return {
+                symbol: td.eq(2).text().trim(),
+                name: td.eq(3).text().trim(),
+                exchange: (0, utils_1.asExchange)(td.eq(4).text().trim()),
+                type: td.eq(5).text().trim(),
+                industry: (0, utils_1.asIndustry)(td.eq(6).text().trim()),
+                listedDate: luxon_1.DateTime.fromFormat(td.eq(7).text().trim(), 'yyyy/MM/dd').toISODate(),
+            };
+        }).toArray();
+        return data;
+    }
+    async fetchListedFutOpt(options) {
+        const { type } = options !== null && options !== void 0 ? options : {};
+        const url = 'https://isin.twse.com.tw/isin/class_main.jsp?market=7';
+        const response = await this.httpService.get(url, { responseType: 'arraybuffer' });
+        const page = iconv.decode(response.data, 'big5');
+        const $ = cheerio.load(page);
+        const data = $('.h4 tr').slice(1).map((_, el) => {
+            const td = $(el).find('td');
+            return {
+                symbol: td.eq(2).text().trim(),
+                name: td.eq(3).text().trim(),
+                exchange: (0, utils_1.asExchange)(td.eq(4).text().trim()),
+                type: td.eq(5).text().trim(),
+                listedDate: luxon_1.DateTime.fromFormat(td.eq(7).text().trim(), 'yyyy/MM/dd').toISODate(),
+            };
+        }).toArray();
+        return data.filter(row => {
+            if (type === 'F')
+                return row.type.includes('期貨');
+            if (type === 'O')
+                return row.type.includes('選擇權');
+            return true;
+        });
+    }
+}
+exports.IsinScraper = IsinScraper;

package/lib/scrapers/mis-taifex-scraper.d.ts

@@ -0,0 +1,17 @@
+import { Scraper } from './scraper';
+import { FutOptQuote, Ticker } from '../interfaces';
+export declare class MisTaifexScraper extends Scraper {
+    fetchListedFutOpt(options?: {
+        type?: 'F' | 'O';
+    }): Promise<any>;
+    fetchFutOptQuoteList(options: {
+        ticker: Ticker;
+        afterhours?: boolean;
+    }): Promise<FutOptQuote[] | null>;
+    fetchFutOptQuoteDetail(options: {
+        ticker: Ticker;
+        afterhours?: boolean;
+    }): Promise<FutOptQuote | null | undefined>;
+    private extractSymbolIdFromTicker;
+    private extractTypeFromCmdyDDLItem;
+}

package/lib/scrapers/mis-taifex-scraper.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MisTaifexScraper = void 0;
+const numeral = require("numeral");
+const luxon_1 = require("luxon");
+const scraper_1 = require("./scraper");
+const enums_1 = require("../enums");
+class MisTaifexScraper extends scraper_1.Scraper {
+    async fetchListedFutOpt(options) {
+        const { type } = options !== null && options !== void 0 ? options : {};
+        const url = 'https://mis.taifex.com.tw/futures/api/getCmdyDDLItemByKind';
+        const body = JSON.stringify({
+            SymbolType: type,
+        });
+        const response = await this.httpService.post(url, body, {
+            headers: { 'Content-Type': 'application/json' },
+        });
+        const json = response.data;
+        const data = json.RtData.Items.map((row) => (Object.assign({ symbol: row.CID, name: row.DispCName, exchange: enums_1.Exchange.TAIFEX, type: type !== null && type !== void 0 ? type : this.extractTypeFromCmdyDDLItem(row) }, (row.SpotID && { underlying: row.SpotID }))));
+        return data;
+    }
+    async fetchFutOptQuoteList(options) {
+        const { ticker, afterhours } = options;
+        const body = JSON.stringify({
+            CID: ticker.symbol,
+            SymbolType: ticker.type,
+            MarketType: afterhours ? 1 : 0,
+        });
+        const url = `https://mis.taifex.com.tw/futures/api/getQuoteList`;
+        const response = await this.httpService.post(url, body, {
+            headers: { 'Content-Type': 'application/json' },
+        });
+        const json = (response.data.RtCode === '0') && response.data;
+        if (!json)
+            return null;
+        const data = json.RtData.QuoteList.map((row) => ({
+            symbol: row.SymbolID.split('-')[0],
+            name: row.DispCName,
+            status: row.Status,
+            openPrice: row.COpenPrice && numeral(row.COpenPrice).value(),
+            highPrice: row.CHighPrice && numeral(row.CHighPrice).value(),
+            lowPrice: row.CLowPrice && numeral(row.CLowPrice).value(),
+            lastPrice: row.CLastPrice && numeral(row.CLastPrice).value(),
+            referencePrice: row.CRefPrice && numeral(row.CRefPrice).value(),
+            limitUpPrice: row.CCeilPrice && numeral(row.CCeilPrice).value(),
+            limitDownPrice: row.CFloorPrice && numeral(row.CFloorPrice).value(),
+            settlementPrice: row.SettlementPrice && numeral(row.SettlementPrice).value(),
+            change: row.CDiff && numeral(row.CDiff).value(),
+            changePercent: row.CDiffRate && numeral(row.CDiffRate).value(),
+            amplitude: row.CAmpRate && numeral(row.CAmpRate).value(),
+            totalVoluem: row.CTotalVolume && numeral(row.CTotalVolume).value(),
+            openInterest: row.OpenInterest && numeral(row.OpenInterest).value(),
+            bestBidPrice: row.CBestBidPrice && numeral(row.CBestBidPrice).value(),
+            bestAskPrice: row.CBestAskPrice && numeral(row.CBestAskPrice).value(),
+            bestBidSize: row.CBestBidSize && numeral(row.CBestBidSize).value(),
+            bestAskSize: row.CBestAskSize && numeral(row.CBestAskSize).value(),
+            testPrice: row.CTestPrice && numeral(row.CTestPrice).value(),
+            testSize: row.CTestVolume && numeral(row.CTestVolume).value(),
+            lastUpdated: row.CTime && luxon_1.DateTime.fromFormat(`${row.CDate} ${row.CTime}`, 'yyyyMMdd hhmmss', { zone: 'Asia/Taipei' }).toMillis(),
+        }));
+        return data;
+    }
+    async fetchFutOptQuoteDetail(options) {
+        const { ticker, afterhours } = options;
+        const body = JSON.stringify({ SymbolID: [this.extractSymbolIdFromTicker(ticker, { afterhours })] });
+        const url = `https://mis.taifex.com.tw/futures/api/getQuoteDetail`;
+        const response = await this.httpService.post(url, body, {
+            headers: { 'Content-Type': 'application/json' },
+        });
+        const json = (response.data.RtCode === '0') && response.data;
+        if (!json)
+            return null;
+        const data = json.RtData.QuoteList.map((row) => ({
+            symbol: ticker.symbol,
+            name: row.DispCName,
+            status: row.Status,
+            referencePrice: row.CRefPrice && numeral(row.CRefPrice).value(),
+            limitUpPrice: row.CCeilPrice && numeral(row.CCeilPrice).value(),
+            limitDownPrice: row.CFloorPrice && numeral(row.CFloorPrice).value(),
+            openPrice: row.COpenPrice && numeral(row.COpenPrice).value(),
+            highPrice: row.CHighPrice && numeral(row.CHighPrice).value(),
+            lowPrice: row.CLowPrice && numeral(row.CLowPrice).value(),
+            lastPrice: row.CLastPrice && numeral(row.CLastPrice).value(),
+            lastSize: row.CSingleVolume && numeral(row.CSingleVolume).value(),
+            testPrice: row.CTestPrice && numeral(row.CTestPrice).value(),
+            testSize: row.CTestVolume && numeral(row.CTestVolume).value(),
+            testTime: row.CTestTime && luxon_1.DateTime.fromFormat(`${row.CDate} ${row.CTestTime}`, 'yyyyMMdd hhmmss', { zone: 'Asia/Taipei' }).toMillis(),
+            totalVoluem: row.CTotalVolume && numeral(row.CTotalVolume).value(),
+            openInterest: row.OpenInterest && numeral(row.OpenInterest).value(),
+            bidOrders: row.CBidCount && numeral(row.CBidCount).value(),
+            askOrders: row.CAskCount && numeral(row.CAskCount).value(),
+            bidVolume: row.CBidUnit && numeral(row.CBidUnit).value(),
+            askVolume: row.CAskUnit && numeral(row.CAskUnit).value(),
+            bidPrice: [row.CBidPrice1, row.CBidPrice2, row.CBidPrice3, row.CBidPrice4, row.CBidPrice5].map(price => numeral(price).value()),
+            askPrice: [row.CAskPrice1, row.CAskPrice2, row.CAskPrice3, row.CAskPrice4, row.CAskPrice5].map(price => numeral(price).value()),
+            bidSize: [row.CBidSize1, row.CBidSize2, row.CBidSize3, row.CBidSize4, row.CBidSize5].map(size => numeral(size).value()),
+            askSize: [row.CAskSize1, row.CAskSize2, row.CAskSize3, row.CAskSize4, row.CAskSize5].map(size => numeral(size).value()),
+            extBidPrice: row.CExtBidPrice && numeral(row.CExtBidPrice).value(),
+            extAskPrice: row.CExtAskPrice && numeral(row.CExtAskPrice).value(),
+            extBidSize: row.CExtBidSize && numeral(row.CExtBidSize).value(),
+            extAskSize: row.CExtAskSize && numeral(row.CExtAskSize).value(),
+            lastUpdated: luxon_1.DateTime.fromFormat(`${row.CDate} ${row.CTime}`, 'yyyyMMdd hhmmss', { zone: 'Asia/Taipei' }).toMillis(),
+        }));
+        return data.find(row => row.symbol.includes(ticker.symbol));
+    }
+    extractSymbolIdFromTicker(ticker, options) {
+        const { symbol, type } = ticker;
+        const { afterhours } = options;
+        if (type && type.includes('期貨')) {
+            return afterhours ? `${symbol}-M` : `${symbol}-F`;
+        }
+        if (type && type.includes('選擇權')) {
+            return afterhours ? `${symbol}-N` : `${symbol}-O`;
+        }
+    }
+    extractTypeFromCmdyDDLItem(item) {
+        const type = item.CID.charAt(2);
+        if (['F', 'O'].includes(type))
+            return type;
+        if (item.DispCName.includes('期貨'))
+            return 'F';
+        if (item.DispCName.includes('選擇權'))
+            return 'O';
+    }
+}
+exports.MisTaifexScraper = MisTaifexScraper;

package/lib/scrapers/mis-twse-scraper.d.ts

@@ -0,0 +1,15 @@
+import { Scraper } from './scraper';
+import { IndexQuote, StockQuote, Ticker } from '../interfaces';
+export declare class MisTwseScraper extends Scraper {
+    fetchListedIndices(options: {
+        exchange: 'TWSE' | 'TPEx';
+    }): Promise<any>;
+    fetchStocksQuote(options: {
+        ticker: Ticker;
+        odd?: boolean;
+    }): Promise<StockQuote | null | undefined>;
+    fetchIndicesQuote(options: {
+        ticker: Ticker;
+    }): Promise<IndexQuote | null | undefined>;
+    private extractExChFromTicker;
+}

package/lib/scrapers/mis-twse-scraper.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MisTwseScraper = void 0;
+const numeral = require("numeral");
+const luxon_1 = require("luxon");
+const scraper_1 = require("./scraper");
+const utils_1 = require("../utils");
+class MisTwseScraper extends scraper_1.Scraper {
+    async fetchListedIndices(options) {
+        const { exchange } = options;
+        const ex = { 'TWSE': 'tse', 'TPEx': 'otc' };
+        const i = { 'TWSE': 'TIDX', 'TPEx': 'OIDX' };
+        const query = new URLSearchParams({
+            ex: ex[exchange],
+            i: i[exchange],
+        });
+        const url = `https://mis.twse.com.tw/stock/api/getCategory.jsp?${query}`;
+        const response = await this.httpService.get(url);
+        const json = (response.data.rtmessage === 'OK') && response.data;
+        if (!json)
+            return null;
+        const data = json.msgArray.map((row) => {
+            var _a;
+            return ({
+                symbol: (_a = (0, utils_1.asIndex)(row.n)) !== null && _a !== void 0 ? _a : (row.ch).replace('.tw', ''),
+                name: row.n,
+                exchange,
+                ex_ch: `${row.ex}_${row.ch}`,
+            });
+        });
+        return data;
+    }
+    async fetchStocksQuote(options) {
+        const { ticker, odd } = options;
+        const query = new URLSearchParams({
+            ex_ch: this.extractExChFromTicker(ticker),
+        });
+        const url = odd
+            ? `https://mis.twse.com.tw/stock/api/getOddInfo.jsp?${query}`
+            : `https://mis.twse.com.tw/stock/api/getStockInfo.jsp?${query}`;
+        const response = await this.httpService.get(url);
+        const json = (response.data.rtmessage === 'OK') && response.data;
+        if (!json)
+            return null;
+        const data = json.msgArray.map((row) => ({
+            date: luxon_1.DateTime.fromFormat(row.d, 'yyyyMMdd').toISODate(),
+            symbol: row.c,
+            name: row.n,
+            referencePrice: row.y && numeral(row.y).value(),
+            limitUpPrice: row.u && numeral(row.u).value(),
+            limitDownPrice: row.w && numeral(row.w).value(),
+            openPrice: row.o && numeral(row.o).value(),
+            highPrice: row.h && numeral(row.h).value(),
+            lowPrice: row.l && numeral(row.l).value(),
+            lastPrice: row.z && numeral(row.z).value(),
+            lastSize: row.s && numeral(row.s).value(),
+            totalVoluem: row.v && numeral(row.v).value(),
+            bidPrice: row.b && row.b.split('_').slice(0, -1).map((price) => numeral(price).value()),
+            askPrice: row.a && row.a.split('_').slice(0, -1).map((price) => numeral(price).value()),
+            bidSize: row.g && row.g.split('_').slice(0, -1).map((size) => numeral(size).value()),
+            askSize: row.f && row.f.split('_').slice(0, -1).map((size) => numeral(size).value()),
+            lastUpdated: row.tlong && numeral(row.tlong).value(),
+        }));
+        return data.find(row => row.symbol === ticker.symbol);
+    }
+    async fetchIndicesQuote(options) {
+        const { ticker } = options;
+        const query = new URLSearchParams({
+            ex_ch: this.extractExChFromTicker(ticker),
+        });
+        const url = `https://mis.twse.com.tw/stock/api/getStockInfo.jsp?${query}`;
+        const response = await this.httpService.get(url);
+        const json = (response.data.rtmessage === 'OK') && response.data;
+        if (!json)
+            return null;
+        const data = json.msgArray.map((row) => ({
+            date: luxon_1.DateTime.fromFormat(row.d, 'yyyyMMdd').toISODate(),
+            symbol: ticker.symbol,
+            name: row.n,
+            previousClose: row.y && numeral(row.y).value(),
+            open: row.o && numeral(row.o).value(),
+            high: row.h && numeral(row.h).value(),
+            low: row.l && numeral(row.l).value(),
+            close: row.z && numeral(row.z).value(),
+            volume: row.v && numeral(row.v).value(),
+            lastUpdated: row.tlong && numeral(row.tlong).value(),
+        }));
+        return data.find(row => row.symbol === ticker.symbol);
+    }
+    extractExChFromTicker(ticker) {
+        const { symbol, exchange, ex_ch } = ticker;
+        const ex = { 'TWSE': 'tse', 'TPEx': 'otc' };
+        const ch = `${symbol}.tw`;
+        return ex_ch ? ex_ch : `${ex[exchange]}_${ch}`;
+    }
+}
+exports.MisTwseScraper = MisTwseScraper;

package/lib/scrapers/mops-scraper.d.ts

@@ -0,0 +1,17 @@
+import { Scraper } from './scraper';
+import { StockEps, StockRevenue } from '../interfaces';
+export declare class MopsScraper extends Scraper {
+    fetchStocksEps(options: {
+        exchange: string;
+        year: number;
+        quarter: number;
+        symbol?: string;
+    }): Promise<StockEps | StockEps[] | null | undefined>;
+    fetchStocksRevenue(options: {
+        exchange: string;
+        year: number;
+        month: number;
+        foreign?: boolean;
+        symbol?: string;
+    }): Promise<StockRevenue | StockRevenue[] | null | undefined>;
+}

package/lib/scrapers/mops-scraper.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MopsScraper = void 0;
+const _ = require("lodash");
+const cheerio = require("cheerio");
+const iconv = require("iconv-lite");
+const numeral = require("numeral");
+const scraper_1 = require("./scraper");
+class MopsScraper extends scraper_1.Scraper {
+    async fetchStocksEps(options) {
+        const { exchange, year, quarter, symbol } = options;
+        const type = { 'TWSE': 'sii', 'TPEx': 'otc' };
+        const form = new URLSearchParams({
+            encodeURIComponent: '1',
+            step: '1',
+            firstin: '1',
+            off: '1',
+            isQuery: 'Y',
+            TYPEK: type[exchange],
+            year: numeral(year).subtract(1911).format(),
+            season: numeral(quarter).format('00'),
+        });
+        const url = 'https://mops.twse.com.tw/mops/web/t163sb04';
+        const response = await this.httpService.post(url, form);
+        if (response.data.includes('查詢無資料!'))
+            return null;
+        const $ = cheerio.load(response.data);
+        const data = $('.even,.odd').map((_, el) => {
+            const td = $(el).find('td');
+            const symbol = td.eq(0).text().trim();
+            const name = td.eq(1).text().trim();
+            const eps = numeral(td.eq(td.length - 1).text().trim()).value();
+            return { exchange, symbol, name, eps, year, quarter };
+        }).toArray();
+        return symbol ? data.find(data => data.symbol === symbol) : _.sortBy(data, 'symbol');
+    }
+    async fetchStocksRevenue(options) {
+        const { exchange, year, month, foreign = false, symbol } = options;
+        const type = { 'TWSE': 'sii', 'TPEx': 'otc' };
+        const suffix = `${numeral(year).subtract(1911).value()}_${month}_${+foreign}`;
+        const url = `https://mops.twse.com.tw/nas/t21/${type[exchange]}/t21sc03_${suffix}.html`;
+        const response = await this.httpService.get(url, { responseType: 'arraybuffer' });
+        const page = iconv.decode(response.data, 'big5');
+        if (page.toString().includes('查無資料'))
+            return null;
+        const $ = cheerio.load(page);
+        const data = $('tr [align=right]')
+            .filter((_, el) => {
+            const th = $(el).find('th');
+            const td = $(el).find('td');
+            return (th.length === 0) && !!td.eq(0).text();
+        })
+            .map((_, el) => {
+            const td = $(el).find('td');
+            const symbol = td.eq(0).text().trim();
+            const name = td.eq(1).text().trim();
+            const revenue = numeral(td.eq(2).text().trim()).value();
+            return { exchange, symbol, name, revenue, year, month };
+        })
+            .toArray();
+        return symbol ? data.find(data => data.symbol === symbol) : _.sortBy(data, 'symbol');
+    }
+}
+exports.MopsScraper = MopsScraper;

package/lib/scrapers/scraper-factory.d.ts

@@ -0,0 +1,25 @@
+import { TwseScraper } from './twse-scraper';
+import { TpexScraper } from './tpex-scraper';
+import { TaifexScraper } from './taifex-scraper';
+import { TdccScraper } from './tdcc-scraper';
+import { MisTwseScraper } from './mis-twse-scraper';
+import { MisTaifexScraper } from './mis-taifex-scraper';
+import { MopsScraper } from './mops-scraper';
+import { IsinScraper } from './isin-scraper';
+import { Scraper } from './scraper';
+import { Scraper as ScraperType } from '../enums';
+import { RateLimitOptions } from '../interfaces';
+export declare class ScraperFactory {
+    private readonly options?;
+    private readonly scrapers;
+    constructor(options?: RateLimitOptions | undefined);
+    get(type: ScraperType): Scraper;
+    getTwseScraper(): TwseScraper;
+    getTpexScraper(): TpexScraper;
+    getTaifexScraper(): TaifexScraper;
+    getTdccScraper(): TdccScraper;
+    getMisTwseScraper(): MisTwseScraper;
+    getMisTaifexScraper(): MisTaifexScraper;
+    getMopsScraper(): MopsScraper;
+    getIsinScraper(): IsinScraper;
+}

package/lib/scrapers/scraper-factory.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScraperFactory = void 0;
+const twse_scraper_1 = require("./twse-scraper");
+const tpex_scraper_1 = require("./tpex-scraper");
+const taifex_scraper_1 = require("./taifex-scraper");
+const tdcc_scraper_1 = require("./tdcc-scraper");
+const mis_twse_scraper_1 = require("./mis-twse-scraper");
+const mis_taifex_scraper_1 = require("./mis-taifex-scraper");
+const mops_scraper_1 = require("./mops-scraper");
+const isin_scraper_1 = require("./isin-scraper");
+const enums_1 = require("../enums");
+class ScraperFactory {
+    constructor(options) {
+        this.options = options;
+        this.scrapers = new Map();
+    }
+    get(type) {
+        let scraper = this.scrapers.get(type);
+        if (!scraper) {
+            const scrapers = {
+                [enums_1.Scraper.Twse]: twse_scraper_1.TwseScraper,
+                [enums_1.Scraper.Tpex]: tpex_scraper_1.TpexScraper,
+                [enums_1.Scraper.Taifex]: taifex_scraper_1.TaifexScraper,
+                [enums_1.Scraper.Tdcc]: tdcc_scraper_1.TdccScraper,
+                [enums_1.Scraper.MisTwse]: mis_twse_scraper_1.MisTwseScraper,
+                [enums_1.Scraper.MisTaifex]: mis_taifex_scraper_1.MisTaifexScraper,
+                [enums_1.Scraper.Mops]: mops_scraper_1.MopsScraper,
+                [enums_1.Scraper.Isin]: isin_scraper_1.IsinScraper,
+            };
+            const ScraperClass = scrapers[type];
+            scraper = new ScraperClass(this.options);
+            this.scrapers.set(type, scraper);
+        }
+        return scraper;
+    }
+    getTwseScraper() {
+        return this.get(enums_1.Scraper.Twse);
+    }
+    getTpexScraper() {
+        return this.get(enums_1.Scraper.Tpex);
+    }
+    getTaifexScraper() {
+        return this.get(enums_1.Scraper.Taifex);
+    }
+    getTdccScraper() {
+        return this.get(enums_1.Scraper.Tdcc);
+    }
+    getMisTwseScraper() {
+        return this.get(enums_1.Scraper.MisTwse);
+    }
+    getMisTaifexScraper() {
+        return this.get(enums_1.Scraper.MisTaifex);
+    }
+    getMopsScraper() {
+        return this.get(enums_1.Scraper.Mops);
+    }
+    getIsinScraper() {
+        return this.get(enums_1.Scraper.Isin);
+    }
+}
+exports.ScraperFactory = ScraperFactory;

package/lib/scrapers/scraper.d.ts

@@ -0,0 +1,6 @@
+import { AxiosInstance } from "axios";
+import { RateLimitOptions } from "../interfaces";
+export declare abstract class Scraper {
+    protected readonly httpService: AxiosInstance;
+    constructor(options?: RateLimitOptions);
+}

package/lib/scrapers/scraper.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scraper = void 0;
+const axios_1 = require("axios");
+const rateLimit = require("axios-rate-limit");
+const https = require("https");
+class Scraper {
+    constructor(options = { limit: 1, ttl: 5000 }) {
+        const maxRequests = options.limit;
+        const perMilliseconds = options.ttl;
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        this.httpService = rateLimit(axios_1.default.create({
+            httpsAgent: new https.Agent({
+                rejectUnauthorized: false,
+            }),
+        }), { maxRequests, perMilliseconds });
+    }
+}
+exports.Scraper = Scraper;

package/lib/scrapers/taifex-scraper.d.ts

@@ -0,0 +1,44 @@
+import { Scraper } from './scraper';
+import { FutOptHistorical, FutOptInstitutional, FutOptLargeTraders, FutOptMxfRetailPosition, FutOptTmfRetailPosition, FutOptTxoPutCallRatio, StockFutOpt } from '../interfaces';
+import { FutOptExchangeRates } from '../interfaces/futopt-exchange-rates.interface';
+export declare class TaifexScraper extends Scraper {
+    fetchListedStockFutOpt(): Promise<StockFutOpt[]>;
+    fetchFuturesHistorical(options: {
+        date: string;
+        symbol?: string;
+        afterhours?: boolean;
+    }): Promise<FutOptHistorical[] | null>;
+    fetchOptionsHistorical(options: {
+        date: string;
+        symbol?: string;
+        afterhours?: boolean;
+    }): Promise<FutOptHistorical[] | null>;
+    fetchFuturesInstitutional(options: {
+        date: string;
+        symbol: string;
+    }): Promise<FutOptInstitutional | null>;
+    fetchOptionsInstitutional(options: {
+        date: string;
+        symbol: string;
+    }): Promise<FutOptInstitutional | null>;
+    fetchFuturesLargeTraders(options: {
+        date: string;
+        symbol: string;
+    }): Promise<FutOptLargeTraders | null>;
+    fetchOptionsLargeTraders(options: {
+        date: string;
+        symbol: string;
+    }): Promise<FutOptLargeTraders | null>;
+    fetchMxfRetailPosition(options: {
+        date: string;
+    }): Promise<FutOptMxfRetailPosition | null>;
+    fetchTmfRetailPosition(options: {
+        date: string;
+    }): Promise<FutOptTmfRetailPosition | null>;
+    fetchTxoPutCallRatio(options: {
+        date: string;
+    }): Promise<FutOptTxoPutCallRatio | null>;
+    fetchExchangeRates(options: {
+        date: string;
+    }): Promise<FutOptExchangeRates | null>;
+}