itsrn/hidabroot

An unofficial API for Hidabroot

Hidabroot API (unofficial)

An (unofficial) API for Hidabroot

Important notice

This API is unofficial, meaning I am not responisble for any damage caused by using this API. This API may be blocked at any time by Hidabroot's team. This API is never stable as Hidabroot can change at any time their website structure that will break this API.

Install

npm install hidabroot

Or with yarn:

yarn add hidabroot

Usage

import { todayNews } from "hidabroot";

todayNews().then((news) => {
  console.log(news);
});
//=> JSON object containing news titles along with their IDs

(also compitable with commonjs)

API

todayNews()

Example

const { todayNews } = require("hidabroot");
todayNews().then((result) => {
  console.log(result);
});

Will return something like this:

{
  "big article block title is here": 123456, //the number is the article ID. can be used with getArticle()
  "first small article block title is here": 123456,
  "second small article block title is here": 123456,
  "third small article block title is here": 123456,
  "fourth small article block title is here": 123456
}

getArticle(id)

id

Type: number

The ID of the article. The ID can be found in the URL: https://www.hidabroot.org/article/X (X is the ID).

Example

const { getArticle } = require("hidabroot");
getArticle(1185334).then((result) => console.log(result));
//gets the content of the article: https://www.hidabroot.org/article/1185334 and then log the content to the console

search(query, options?)

query

Type: string

The query to search for in the website.

options

Type: searchOptions

The options for the search. Recommended to get better results.

Example

import { search } from "hidabroot";

const response = await search("האם היו עולמות קודמים?", {
  searchOptions: { searchType: "faq" }, // "faq" means "Ask The Rabbi" questions
});
console.log(response);

Which return to the console something like this:

{
  "url for result": "result title"
}

Currently (v0.8.0), the search is capable to return ~10-15 results. This may be changed in the future.

askTheRabbi(questionID)

questionID

Type: number

The "Ask The Rabbi" question ID. Can be found in https://www.hidabroot.org/question/X where X is the question ID.

Example

import { askTheRabbi, idExtracter } from "hidabroot";

const questionID = idExtracter("https://www.hidabroot.org/question/75137", {
  pageType: "askTheRabbi",
});
const response = await askTheRabbi(questionID);
console.log(response);

Which return to the console something like this:

{
  "title": "the question title",
  "question": "the question",
  "answer": "the rabbi answer"
}

(or null if the page wasn't found or if an error occurred)

idExtracter(input, options)

input

Type: string

The input URL of the Hidabroot page to extract the ID from.

options

Type: idExtracterOptions

The options for the extract process.

Example

import { idExtracter } from "hidabroot";

const questionID = idExtracter("https://www.hidabroot.org/question/75137", {
  pageType: "askTheRabbi",
});
console.log(questionID);
//=> 75137

Contributing

All contributions are welcome! Feel free to open an issue (just search the issue tracker before opening an issue to make sure your issue hasn't already been reported or answered) or a pull request.

hidabroot's Issues

The package doesn't work on replit

Description

When using the package in replit, I get the following error:

Error: Error: Could not find Chrome (ver. 115.0.5790.98). This can occur if either
 1. you did not perform an installation before running the script (e.g. `npm install`) or
 2. your cache path is incorrectly configured (which is: /home/runner/.cache/puppeteer).
For (2), check out our guide on configuring puppeteer at https://pptr.dev/guides/configuration.

Steps to reproduce

1. Install the package in replit
2. Use todayNews() function
3. Get the error

Expected behavior

The function should work and return the array as expected

Hidabroot API Version

0.5.5-beta

Operating System

• macOS
• Windows
• #7

Change readme installation package name

Right now, the package name in the README is "@itsrn/hidabroot" instead of "hidabroot".

Package doesn't work

Description

The package does not work because the /build/index.js does not exist.

Steps to reproduce

1. Install the package
2. Import the package
3. Get the error:

Error: Cannot find module '..../node_modules/hidabroot/build/index.js'. Please verify that the package.json has a valid "main" entry

Expected behavior

Able to use the package

Hidabroot API Version

0.5.3-beta

Operating System

• macOS
• Windows
• Linux