herold-api-ts 1.0.0

package/README.md

@@ -0,0 +1,277 @@
+# Herold.at API
+
+A TypeScript library for scraping data from Herold.at Gelbe Seiten (Austrian yellow pages). This package provides functions to search business listings, fetch categories, extract contact information, and get detailed business information.
+
+## Installation
+
+```bash
+npm install hr-api-ts
+# or
+pnpm add hr-api-ts
+# or
+yarn add hr-api-ts
+```
+
+## Usage
+
+### Basic Import
+
+```typescript
+import {
+  searchListings,
+  getEmailById,
+  getInfo,
+  getAutocompleteSuggestions,
+} from "hr-api-ts";
+```
+
+### Search Business Listings
+
+```typescript
+import { searchListings } from "hr-api-ts";
+
+const result = await searchListings({
+  was: "arzt", // Search term (what to search for)
+  position: "20", // Position/offset
+  umkreis: "-1", // Radius (-1 = no limit)
+  anzahl: "10", // Number of results
+  sortierung: "relevanz", // Sort order: "relevanz", "name", "plz"
+});
+
+if (result.success) {
+  console.log(result.data); // Array of ListingResult
+  console.log(result.metadata); // Additional metadata
+} else {
+  console.error(result.error);
+}
+```
+
+### Get Detailed Business Information
+
+```typescript
+import { getInfo } from "hr-api-ts";
+
+const businessInfo = await getInfo("listing-id-here");
+
+if (businessInfo.success) {
+  console.log("Business Name:", businessInfo.data.name);
+  console.log("Email:", businessInfo.data.email);
+  console.log("Phone:", businessInfo.data.phone);
+  console.log(
+    "Address:",
+    businessInfo.data.street,
+    businessInfo.data.plz,
+    businessInfo.data.city
+  );
+  console.log("Website:", businessInfo.data.website);
+  console.log("Fax:", businessInfo.data.fax);
+} else {
+  console.error(businessInfo.error);
+}
+```
+
+### Get Email by Listing ID
+
+```typescript
+import { getEmailById } from "hr-api-ts";
+
+const emailResult = await getEmailById("listing-id-here");
+
+if (emailResult.success && emailResult.data) {
+  console.log("Email:", emailResult.data);
+} else {
+  console.log("No email found or error occurred");
+}
+```
+
+### Get Autocomplete Suggestions
+
+```typescript
+import { getAutocompleteSuggestions } from "hr-api-ts";
+
+const autocompleteResult = await getAutocompleteSuggestions("aut");
+
+if (autocompleteResult.success) {
+  console.log("Suggestions:", autocompleteResult.data);
+  // Output: ["Auto", "Autoreparaturen", "Autoteile", "Autoverleih", ...]
+} else {
+  console.error("Autocomplete failed:", autocompleteResult.error);
+}
+```
+
+### Fetch Categories
+
+```typescript
+import {
+  fetchCategoryNamesById,
+  fetchMainCategoryUrls,
+  fetchAllSubcategoryNames,
+  extractCategoryIdsFromUrl,
+} from "hr-api-ts";
+
+// Get category names by ID
+const categories = await fetchCategoryNamesById("category-id");
+
+// Get main category URLs
+const mainCategories = await fetchMainCategoryUrls();
+
+// Get all subcategory names
+const allSubcategories = await fetchAllSubcategoryNames();
+
+// Extract category IDs from a page URL
+const categoryIds = await extractCategoryIdsFromUrl(
+  "https://www.herold.at/gelbe-seiten/branchenbuch"
+);
+```
+
+## Types
+
+### ListingSearchParams
+
+```typescript
+interface ListingSearchParams {
+  was?: string; // Search term
+  position?: string; // Position/offset
+  umkreis?: string; // Radius (-1 = no limit)
+  anzahl?: string; // Number of results
+  sortierung?: string; // Sort order
+  verwandt?: string; // Related search
+}
+```
+
+### ListingResult
+
+```typescript
+interface ListingResult {
+  id: string; // Unique listing ID
+  name: string; // Business name
+  website?: string; // Website URL (if available)
+  email?: string; // Email (if available)
+}
+```
+
+### BusinessInfo
+
+```typescript
+interface BusinessInfo {
+  name?: string; // Business name
+  email?: string; // Email address
+  street?: string; // Street address
+  city?: string; // City name
+  plz?: string; // Postal code
+  phone?: string; // Phone number
+  fax?: string; // Fax number
+  website?: string; // Website URL
+}
+```
+
+### AutocompleteResponse
+
+```typescript
+interface AutocompleteResponse {
+  vorschlaege: string[]; // Array of autocomplete suggestions
+  werbung: null; // Advertising field (always null)
+}
+```
+
+### ScrapingResult
+
+```typescript
+interface ScrapingResult<T> {
+  data: T;
+  success: boolean;
+  error?: string;
+  metadata?: {
+    anzahlTreffer?: number;
+    anzahlMehrTreffer?: number;
+    gesamtanzahlTreffer?: number;
+  };
+}
+```
+
+## Available Functions
+
+### Core Functions
+
+- `searchListings(params: ListingSearchParams)` - Search for business listings
+- `getInfo(listingId: string)` - Get detailed business information (name, email, phone, address, website, fax)
+- `getEmailById(listingId: string)` - Get email for a specific listing (backward compatibility)
+- `getAutocompleteSuggestions(tag: string)` - Get autocomplete suggestions for search terms
+- `fetchCategoryNamesById(categoryId: string)` - Get category names by ID
+- `fetchMainCategoryUrls()` - Get main category URLs
+- `extractCategoryIdsFromUrl(pageUrl: string)` - Extract category IDs from a page
+- `fetchAllSubcategoryNames()` - Get all subcategory names
+
+### Aliases (for backward compatibility)
+
+- `searchListingsByParams` - Alias for `searchListings`
+- `getEmailByListingId` - Alias for `getEmailById`
+- `getInfoByListingId` - Alias for `getInfo`
+- `getCategorieNamesByID` - Alias for `fetchCategoryNamesById`
+- `getMainCategories` - Alias for `fetchMainCategoryUrls`
+- `getIdsByUrl` - Alias for `extractCategoryIdsFromUrl`
+- `getAllSubcategories` - Alias for `fetchAllSubcategoryNames`
+
+## Example Usage
+
+```typescript
+import { searchListings, getInfo, getAutocompleteSuggestions } from "hr-api-ts";
+
+async function findAndGetBusinessInfo() {
+  // Get autocomplete suggestions first
+  const suggestions = await getAutocompleteSuggestions("arzt");
+  if (suggestions.success) {
+    console.log("Available suggestions:", suggestions.data);
+  }
+
+  // Search for doctors
+  const searchResult = await searchListings({
+    was: "arzt",
+    anzahl: "5",
+    sortierung: "relevanz",
+  });
+
+  if (searchResult.success && searchResult.data.length > 0) {
+    // Get detailed info for the first result
+    const firstListing = searchResult.data[0];
+    const businessInfo = await getInfo(firstListing.id);
+
+    if (businessInfo.success) {
+      console.log("Found business:", businessInfo.data);
+    }
+  }
+}
+```
+
+## CLI Usage
+
+You can also run the package directly as a CLI tool:
+
+```bash
+# Build the project
+pnpm build
+
+# Run the example script
+pnpm example
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Run in development mode
+pnpm dev
+
+# Build for production
+pnpm build
+```
+
+## License
+
+ISC
+
+## Disclaimer
+
+This library is for educational and research purposes. Please respect the terms of service of Herold.at and use this library responsibly. Make sure to comply with their robots.txt and rate limiting policies.

package/dist/gsHelper.d.ts

@@ -0,0 +1,17 @@
+import { ScrapingResult, ListingSearchParams, ListingResult, BusinessInfo } from "./types";
+export declare function fetchCategoryNamesById(categoryId: string): Promise<ScrapingResult<string[]>>;
+export declare function fetchMainCategoryUrls(): Promise<ScrapingResult<string[]>>;
+export declare function extractCategoryIdsFromUrl(pageUrl: string): Promise<ScrapingResult<string[]>>;
+export declare function fetchAllSubcategoryNames(): Promise<ScrapingResult<string[]>>;
+export declare const getCategorieNamesByID: typeof fetchCategoryNamesById;
+export declare const getMainCategories: typeof fetchMainCategoryUrls;
+export declare const getIdsByUrl: typeof extractCategoryIdsFromUrl;
+export declare const getAllSubcategories: typeof fetchAllSubcategoryNames;
+export declare const searchListingsByParams: typeof searchListings;
+export declare const getInfoByListingId: typeof getInfo;
+export declare function getEmailById(listingId: string): Promise<ScrapingResult<string | null>>;
+export declare const getEmailByListingId: typeof getEmailById;
+export declare function searchListings(params: ListingSearchParams): Promise<ScrapingResult<ListingResult[]>>;
+export declare function getInfo(listingIdOrUrl: string): Promise<ScrapingResult<BusinessInfo>>;
+export declare function getAutocompleteSuggestions(tag: string): Promise<ScrapingResult<string[]>>;
+//# sourceMappingURL=gsHelper.d.ts.map

package/dist/gsHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsHelper.d.ts","sourceRoot":"","sources":["../src/gsHelper.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EAGb,YAAY,EAEb,MAAM,SAAS,CAAC;AAejB,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAsBnC;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CACpD,cAAc,CAAC,MAAM,EAAE,CAAC,CACzB,CA4BA;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAgCnC;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CACvD,cAAc,CAAC,MAAM,EAAE,CAAC,CACzB,CAiCA;AAED,eAAO,MAAM,qBAAqB,+BAAyB,CAAC;AAC5D,eAAO,MAAM,iBAAiB,8BAAwB,CAAC;AACvD,eAAO,MAAM,WAAW,kCAA4B,CAAC;AACrD,eAAO,MAAM,mBAAmB,iCAA2B,CAAC;AAC5D,eAAO,MAAM,sBAAsB,uBAAiB,CAAC;AACrD,eAAO,MAAM,kBAAkB,gBAAU,CAAC;AAE1C,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAMxC;AAED,eAAO,MAAM,mBAAmB,qBAAe,CAAC;AAUhD,wBAAsB,cAAc,CAClC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC,CA4F1C;AAED,wBAAsB,OAAO,CAC3B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CA8FvC;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAuCnC"}

package/dist/gsHelper.js

@@ -0,0 +1,387 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEmailByListingId = exports.getInfoByListingId = exports.searchListingsByParams = exports.getAllSubcategories = exports.getIdsByUrl = exports.getMainCategories = exports.getCategorieNamesByID = void 0;
+exports.fetchCategoryNamesById = fetchCategoryNamesById;
+exports.fetchMainCategoryUrls = fetchMainCategoryUrls;
+exports.extractCategoryIdsFromUrl = extractCategoryIdsFromUrl;
+exports.fetchAllSubcategoryNames = fetchAllSubcategoryNames;
+exports.getEmailById = getEmailById;
+exports.searchListings = searchListings;
+exports.getInfo = getInfo;
+exports.getAutocompleteSuggestions = getAutocompleteSuggestions;
+const cheerio = __importStar(require("cheerio"));
+const axios_1 = __importDefault(require("axios"));
+async function fetchHtml(url) {
+    try {
+        const response = await axios_1.default.get(url);
+        return response.data;
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch ${url}: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+}
+async function fetchCategoryNamesById(categoryId) {
+    try {
+        const url = `https://www.herold.at/gelbe-seiten/branchenbuch/rubriken/${categoryId}`;
+        const html = await fetchHtml(url);
+        const $ = cheerio.load(html);
+        const categoryNames = [];
+        $(".rubrik__list .table-grid__item a.link, .category-list a, .branchen-list a").each((_, element) => {
+            const categoryName = $(element).text().trim();
+            if (categoryName) {
+                categoryNames.push(categoryName);
+            }
+        });
+        return { data: categoryNames, success: true };
+    }
+    catch (error) {
+        return {
+            data: [],
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+async function fetchMainCategoryUrls() {
+    try {
+        const url = "https://www.herold.at/gelbe-seiten/branchenbuch";
+        const html = await fetchHtml(url);
+        const $ = cheerio.load(html);
+        const categoryUrls = [];
+        $(".citypages__country-pagesection-slider .gc-iconbox__link, .category-slider a, .main-categories a, .region-list a").each((_, element) => {
+            const href = $(element).attr("href");
+            if (href) {
+                const absoluteUrl = href.startsWith("http")
+                    ? href
+                    : `https://www.herold.at${href}`;
+                categoryUrls.push(absoluteUrl);
+            }
+        });
+        const uniqueUrls = [...new Set(categoryUrls)];
+        return { data: uniqueUrls, success: true };
+    }
+    catch (error) {
+        return {
+            data: [],
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+async function extractCategoryIdsFromUrl(pageUrl) {
+    try {
+        const html = await fetchHtml(pageUrl);
+        const $ = cheerio.load(html);
+        const urls = [];
+        $('.branchenseiten__grid a[href*="rubriken/"], .category-grid a[href*="rubriken/"], a[href*="/rubriken/"]').each((_, element) => {
+            const href = $(element).attr("href");
+            if (href) {
+                urls.push(href);
+            }
+        });
+        const ids = [
+            ...new Set(urls
+                .map((url) => {
+                const match = url.match(/rubriken\/(\d+)/);
+                return match ? match[1] : null;
+            })
+                .filter((id) => id !== null)),
+        ];
+        return { data: ids, success: true };
+    }
+    catch (error) {
+        return {
+            data: [],
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+async function fetchAllSubcategoryNames() {
+    try {
+        const mainCategoriesResult = await fetchMainCategoryUrls();
+        if (!mainCategoriesResult.success) {
+            return mainCategoriesResult;
+        }
+        const allCategoryNames = [];
+        const mainCategories = mainCategoriesResult.data;
+        for (const mainCategoryUrl of mainCategories) {
+            const idsResult = await extractCategoryIdsFromUrl(mainCategoryUrl);
+            if (!idsResult.success) {
+                continue;
+            }
+            for (const categoryId of idsResult.data) {
+                const categoryNamesResult = await fetchCategoryNamesById(categoryId);
+                if (categoryNamesResult.success) {
+                    allCategoryNames.push(...categoryNamesResult.data);
+                }
+            }
+        }
+        const uniqueCategoryNames = [...new Set(allCategoryNames)];
+        return { data: uniqueCategoryNames, success: true };
+    }
+    catch (error) {
+        return {
+            data: [],
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+exports.getCategorieNamesByID = fetchCategoryNamesById;
+exports.getMainCategories = fetchMainCategoryUrls;
+exports.getIdsByUrl = extractCategoryIdsFromUrl;
+exports.getAllSubcategories = fetchAllSubcategoryNames;
+exports.searchListingsByParams = searchListings;
+exports.getInfoByListingId = getInfo;
+async function getEmailById(listingId) {
+    const result = await getInfo(listingId);
+    if (result.success) {
+        return { data: result.data.email || null, success: true };
+    }
+    return { data: null, success: false, error: result.error };
+}
+exports.getEmailByListingId = getEmailById;
+function decodeBase64(str) {
+    try {
+        return Buffer.from(str, "base64").toString("utf-8");
+    }
+    catch (error) {
+        return "";
+    }
+}
+async function searchListings(params) {
+    try {
+        const searchParams = new URLSearchParams();
+        if (params.was) {
+            searchParams.append("term", params.was);
+        }
+        const page = params.position ? Math.floor(parseInt(params.position) / 20) + 1 : 1;
+        if (page > 1) {
+            searchParams.append("seite", page.toString());
+        }
+        if (params.umkreis && params.umkreis !== "-1") {
+            searchParams.append("umkreis", params.umkreis);
+        }
+        if (params.sortierung) {
+            searchParams.append("sortierung", params.sortierung);
+        }
+        const searchUrl = `https://www.herold.at/gelbe-seiten/suche/?${searchParams.toString()}`;
+        const html = await fetchHtml(searchUrl);
+        const $ = cheerio.load(html);
+        const listings = [];
+        $("li.location-search-result, li[itemProp='itemListElement']").each((_, element) => {
+            const $element = $(element);
+            const article = $element.find("article[itemScope]").first();
+            if (!article.length)
+                return;
+            const detailLink = article.find('a[href*="/gelbe-seiten/"]').first();
+            if (!detailLink.length)
+                return;
+            const href = detailLink.attr("href") || "";
+            const listingIdMatch = href.match(/\/gelbe-seiten\/[^\/]+\/([^\/]+)\//);
+            const listingId = listingIdMatch ? listingIdMatch[1] :
+                article.find('meta[itemProp="identifier"]').attr("content") ||
+                    "";
+            if (!listingId)
+                return;
+            let listingName = article.find('meta[itemProp="name"]').attr("content") ||
+                article.find("h2, h3, h4, a[itemProp='url'] span").first().text().trim();
+            if (!listingName) {
+                listingName = detailLink.text().trim();
+            }
+            if (!listingName) {
+                listingName = article.find("a").first().text().trim();
+            }
+            const listing = {
+                id: listingId,
+                name: listingName || "Unknown",
+                detailUrl: href.startsWith("http") ? href : `https://www.herold.at${href}`,
+            };
+            const websiteLink = article.find('a[href^="http"]:not([href*="herold.at"])').first();
+            if (websiteLink.length) {
+                const website = websiteLink.attr("href");
+                if (website && website.startsWith("http")) {
+                    listing.website = website;
+                }
+            }
+            listings.push(listing);
+        });
+        const metadata = {};
+        const resultCountText = $("h1, .result-count, .anzahl-treffer, .search-results-count").text();
+        const countMatch = resultCountText.match(/(\d+)\s+Ergebnisse/);
+        if (countMatch) {
+            metadata.gesamtanzahlTreffer = parseInt(countMatch[1], 10);
+            metadata.anzahlTreffer = listings.length;
+        }
+        return {
+            data: listings,
+            success: true,
+            metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+        };
+    }
+    catch (error) {
+        return {
+            data: [],
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+async function getInfo(listingIdOrUrl) {
+    try {
+        let url;
+        if (listingIdOrUrl.startsWith("http")) {
+            url = listingIdOrUrl;
+        }
+        else {
+            url = `https://www.herold.at/gelbe-seiten/firma/${listingIdOrUrl}`;
+        }
+        const html = await fetchHtml(url);
+        const $ = cheerio.load(html);
+        const businessInfo = {};
+        const nameElement = $(".firmen-name, .company-name, .mod-Kontaktdaten__container .gc-text--h2, h1, .business-name");
+        if (nameElement.length > 0) {
+            businessInfo.name = nameElement.first().text().trim();
+        }
+        const emailButton = $("#email_versenden, .email-button, [data-email], a[href^='mailto:']");
+        if (emailButton.length > 0) {
+            const dataLink = emailButton.attr("data-link") || emailButton.attr("href") || emailButton.attr("data-email");
+            if (dataLink && dataLink.startsWith("mailto:")) {
+                const email = dataLink.replace("mailto:", "").split("?")[0];
+                businessInfo.email = email;
+            }
+            else if (dataLink && dataLink.includes("@")) {
+                businessInfo.email = dataLink;
+            }
+        }
+        const streetAddress = $('meta[itemProp="streetAddress"]').attr("content");
+        const postalCode = $('meta[itemProp="postalCode"]').attr("content");
+        const addressRegion = $('meta[itemProp="addressRegion"]').attr("content");
+        if (streetAddress) {
+            businessInfo.street = streetAddress;
+        }
+        if (postalCode) {
+            businessInfo.plz = postalCode;
+        }
+        if (addressRegion) {
+            businessInfo.city = addressRegion;
+        }
+        if (!businessInfo.street || !businessInfo.city) {
+            const addressContainer = $(".address, .adresse, .mod-Kontaktdaten__address-container, .contact-address, [itemProp='address']");
+            if (addressContainer.length > 0) {
+                const addressText = addressContainer.find(".adresse-text, .address-text, .street-address, span").first();
+                if (addressText.length > 0) {
+                    const fullAddress = addressText.text().trim();
+                    const addressMatch = fullAddress.match(/^(.+?)\s+(\d{4,5})\s+(.+)$/);
+                    if (addressMatch) {
+                        if (!businessInfo.street)
+                            businessInfo.street = addressMatch[1];
+                        if (!businessInfo.plz)
+                            businessInfo.plz = addressMatch[2];
+                        if (!businessInfo.city)
+                            businessInfo.city = addressMatch[3];
+                    }
+                }
+            }
+        }
+        const phoneElement = $('.phone, .telefon, .mod-Kontaktdaten__list-item.contains-icon-big-tel span[data-role="telefonnummer"] a, [data-phone], a[href^="tel:"]');
+        if (phoneElement.length > 0) {
+            const phoneText = phoneElement.text().trim() || phoneElement.attr("href")?.replace("tel:", "");
+            if (phoneText) {
+                businessInfo.phone = phoneText;
+            }
+        }
+        const faxElement = $(".fax, .mod-Kontaktdaten__list-item.contains-icon-big-fax span, [data-fax]");
+        if (faxElement.length > 0) {
+            businessInfo.fax = faxElement.text().trim();
+        }
+        const websiteElement = $(".website, .homepage, .mod-Kontaktdaten__list-item.contains-icon-big-homepage a, [data-website], a[href^='http']");
+        if (websiteElement.length > 0) {
+            const website = websiteElement.attr("href");
+            if (website && website.startsWith("http")) {
+                businessInfo.website = website;
+            }
+        }
+        return { data: businessInfo, success: true };
+    }
+    catch (error) {
+        return {
+            data: {},
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+async function getAutocompleteSuggestions(tag) {
+    try {
+        const url = `https://www.herold.at/gelbe-seiten/vorschlagsliste/was?opposite=&tag=${encodeURIComponent(tag)}`;
+        try {
+            const response = await axios_1.default.get(url);
+            if (response.data && typeof response.data === 'object' && 'vorschlaege' in response.data) {
+                const data = response.data;
+                return { data: data.vorschlaege, success: true };
+            }
+        }
+        catch (apiError) {
+        }
+        const searchUrl = `https://www.herold.at/gelbe-seiten/suche/?term=${encodeURIComponent(tag)}`;
+        const html = await fetchHtml(searchUrl);
+        const $ = cheerio.load(html);
+        const suggestions = [];
+        $(".autocomplete-suggestion, .suggestion-item, .search-suggestion, [data-suggestion], .related-branches a, .verwandte-branchen a").each((_, element) => {
+            const suggestion = $(element).text().trim();
+            if (suggestion) {
+                suggestions.push(suggestion);
+            }
+        });
+        if (suggestions.length > 0) {
+            return { data: suggestions, success: true };
+        }
+        return { data: [], success: true };
+    }
+    catch (error) {
+        return {
+            data: [],
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+//# sourceMappingURL=gsHelper.js.map

package/dist/gsHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsHelper.js","sourceRoot":"","sources":["../src/gsHelper.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { fetchCategoryNamesById, fetchMainCategoryUrls, extractCategoryIdsFromUrl, fetchAllSubcategoryNames, searchListings, getEmailById, getInfo, getCategorieNamesByID, getMainCategories, getIdsByUrl, getAllSubcategories, searchListingsByParams, getEmailByListingId, getInfoByListingId, getAutocompleteSuggestions, } from "./gsHelper";
+export type { ScrapingResult, ListingSearchParams, ListingResult, BusinessInfo, AjaxSearchResponse, WipePageItem, AutocompleteResponse, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,OAAO,EACP,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAutocompleteSuggestions = exports.getInfoByListingId = exports.getEmailByListingId = exports.searchListingsByParams = exports.getAllSubcategories = exports.getIdsByUrl = exports.getMainCategories = exports.getCategorieNamesByID = exports.getInfo = exports.getEmailById = exports.searchListings = exports.fetchAllSubcategoryNames = exports.extractCategoryIdsFromUrl = exports.fetchMainCategoryUrls = exports.fetchCategoryNamesById = void 0;
+var gsHelper_1 = require("./gsHelper");
+Object.defineProperty(exports, "fetchCategoryNamesById", { enumerable: true, get: function () { return gsHelper_1.fetchCategoryNamesById; } });
+Object.defineProperty(exports, "fetchMainCategoryUrls", { enumerable: true, get: function () { return gsHelper_1.fetchMainCategoryUrls; } });
+Object.defineProperty(exports, "extractCategoryIdsFromUrl", { enumerable: true, get: function () { return gsHelper_1.extractCategoryIdsFromUrl; } });
+Object.defineProperty(exports, "fetchAllSubcategoryNames", { enumerable: true, get: function () { return gsHelper_1.fetchAllSubcategoryNames; } });
+Object.defineProperty(exports, "searchListings", { enumerable: true, get: function () { return gsHelper_1.searchListings; } });
+Object.defineProperty(exports, "getEmailById", { enumerable: true, get: function () { return gsHelper_1.getEmailById; } });
+Object.defineProperty(exports, "getInfo", { enumerable: true, get: function () { return gsHelper_1.getInfo; } });
+Object.defineProperty(exports, "getCategorieNamesByID", { enumerable: true, get: function () { return gsHelper_1.getCategorieNamesByID; } });
+Object.defineProperty(exports, "getMainCategories", { enumerable: true, get: function () { return gsHelper_1.getMainCategories; } });
+Object.defineProperty(exports, "getIdsByUrl", { enumerable: true, get: function () { return gsHelper_1.getIdsByUrl; } });
+Object.defineProperty(exports, "getAllSubcategories", { enumerable: true, get: function () { return gsHelper_1.getAllSubcategories; } });
+Object.defineProperty(exports, "searchListingsByParams", { enumerable: true, get: function () { return gsHelper_1.searchListingsByParams; } });
+Object.defineProperty(exports, "getEmailByListingId", { enumerable: true, get: function () { return gsHelper_1.getEmailByListingId; } });
+Object.defineProperty(exports, "getInfoByListingId", { enumerable: true, get: function () { return gsHelper_1.getInfoByListingId; } });
+Object.defineProperty(exports, "getAutocompleteSuggestions", { enumerable: true, get: function () { return gsHelper_1.getAutocompleteSuggestions; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAgBoB;AAflB,kHAAA,sBAAsB,OAAA;AACtB,iHAAA,qBAAqB,OAAA;AACrB,qHAAA,yBAAyB,OAAA;AACzB,oHAAA,wBAAwB,OAAA;AACxB,0GAAA,cAAc,OAAA;AACd,wGAAA,YAAY,OAAA;AACZ,mGAAA,OAAO,OAAA;AACP,iHAAA,qBAAqB,OAAA;AACrB,6GAAA,iBAAiB,OAAA;AACjB,uGAAA,WAAW,OAAA;AACX,+GAAA,mBAAmB,OAAA;AACnB,kHAAA,sBAAsB,OAAA;AACtB,+GAAA,mBAAmB,OAAA;AACnB,8GAAA,kBAAkB,OAAA;AAClB,sHAAA,0BAA0B,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+export interface ScrapingResult<T> {
+    data: T;
+    success: boolean;
+    error?: string;
+    metadata?: {
+        anzahlTreffer?: number;
+        anzahlMehrTreffer?: number;
+        gesamtanzahlTreffer?: number;
+    };
+}
+export interface ListingSearchParams {
+    was?: string;
+    position?: string;
+    umkreis?: string;
+    anzahl?: string;
+    sortierung?: string;
+    verwandt?: string;
+}
+export interface ListingResult {
+    id: string;
+    name: string;
+    website?: string;
+    email?: string;
+    detailUrl?: string;
+}
+export interface BusinessInfo {
+    name?: string;
+    email?: string;
+    street?: string;
+    city?: string;
+    plz?: string;
+    phone?: string;
+    fax?: string;
+    website?: string;
+}
+export interface AjaxSearchResponse {
+    anzahlTreffer: number;
+    anzahlMehrTreffer: number;
+    gesamtanzahlTreffer: number;
+    wipePageItemsJson: string;
+    html: string;
+    karteVorschauUrl: string;
+    koordinatenFuerGrosseKarte: string;
+}
+export interface WipePageItem {
+    na: string;
+    oat: string;
+    pos: string;
+    ttf: string;
+    bi: string;
+    id: string;
+    oid: string;
+    pn: string;
+    cid: string;
+}
+export interface AutocompleteResponse {
+    vorschlaege: string[];
+    werbung: null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,IAAI,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "herold-api-ts",
+  "version": "1.0.0",
+  "description": "hr-api-ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "author": "osbeer",
+  "license": "ISC",
+  "dependencies": {
+    "axios": "^1.12.2",
+    "cheerio": "^1.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.21",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "example": "ts-node example/example.ts"
+  }
+}