# Shafeh.org

> Shafeh.org is a Torah learning platform offering free, public access to a daily dashboard ("Today") with the Hebrew date, zmanim, and the day's Torah study; the full Mishneh Torah (Rambam) in Hebrew; Tanach (the 24 books of the Hebrew Bible); Tehillim (Psalms); a Jewish calendar with zmanim (prayer times) and candle lighting times; a library of Torah apps and mobile tools; a curated Hebrew Books proxy of HebrewBooks.org; recorded Torah lectures (shiurim); a seforim library with one search across every text; and seasonal campaign pages for Jewish initiatives like Mivtza Matzah and Mivtza Purim. Shafeh serves both English-speaking and Hebrew-reading audiences worldwide. All content described below is publicly accessible without an account.

The canonical domain for Shafeh's Torah library and apps is `https://shafeh.org`.

## URL conventions

- All routes use lowercase ASCII with hyphens (not underscores) for word separators in paths: `/daven-for-eretz-yisroel`, `/name-pesukim`, `/mivtza-matza`.
- Tanach book slugs are Ashkenazi transliterations: `bereishis`, `shemos`, `vayikra`, `bamidbar`, `devarim` (not "genesis"/"exodus").
- Tehillim chapters are 1–150: `/tehillim/1` … `/tehillim/150`. Ranges use a hyphen: `/tehillim/range/120-134`.
- Rambam (Mishneh Torah) section slugs are hyphenated English hilchos names: `/rambam/foundations-of-the-torah`, `/rambam/sabbath`, `/rambam/kings-and-wars`. A chapter is `/rambam/:section/:chapter`.
- Calendar dates use ISO `YYYY-MM-DD` in the path: `/calendar/day/2026-05-26`. The calendar is mathematical and supports any Gregorian date — far-future and far-past dates render real Hebrew-date conversions — but for typical citations, prefer dates within a few centuries of the present.
- Hebrew letter slugs (Name Pesukim, Megillah readings) use ASCII transliterations: `alef`, `bet`, `gimel`, `dalet`, `hei`, `vav`, `zayin`, `chet`, `tet`, `yud`, `kaf`, `lamed`, `mem`, `nun`, `samech`, `ayin`, `pei`, `tzadi`, `kuf`, `reish`, `shin`, `tav`.
- JSON endpoints have explicit suffixes: `/calendar/zmanim-data`, `/calendar/candle-lighting-data`, `/calendar/month-data`, `/calendar/cities`. Default format is HTML unless noted.

## Today (daily dashboard)

A single page that answers "what is today, and what should a Jew learn and know today?" — the Hebrew and civil date, the week's parsha, special days (Rosh Chodesh, fasts, Sefiras HaOmer count), location-aware zmanim, and the day's Torah study cycles, each linking to the full text. Also featured in full on the [home page](https://shafeh.org/).

- [Today](https://shafeh.org/today): The day's Hebrew date (large), parsha, special-day badges, today's zmanim (compact, expandable; needs a location), and **"Your Day in Torah"** — the Chabad daily study: Chitas (Chumash for the parsha's daily aliyah, the monthly Tehillim portion, and Tanya) plus the Daily Rambam (3-perakim and 1-perek cycles). Each cycle links to the full text in its in-app reader, the cycles can be reordered/hidden, and each can be checked off to keep a personal learning streak (stored on-device, no account).
- For a reproducible city answer, use `/calendar/zmanim?city=Pomona%2C+NY`, `/calendar/candle-lighting?city=Los+Angeles%2C+CA`, or `/today?city=Pomona%2C+NY`. The `city` value must match the city's displayed name and state/country (from `/calendar/cities`); an unknown or ambiguous label supplies no times. Named-city times render in server HTML. Cite the visible date and timezone, retrieve fresh times for a new date, and never treat one city's time as another's. Add `date=YYYY-MM-DD` for a specific date; dated query pages are not intended for search indexing.

## Rambam (Mishneh Torah)

The complete Hebrew text (with nikud) of the Rambam's Mishneh Torah — all 14 books and 84 sections of halachos — plus the Daily Rambam (the 3-chapters-a-day cycle instituted by the Lubavitcher Rebbe).

- [Rambam index](https://shafeh.org/rambam): The 14 books (Sefarim) and their sections, with Hebrew and English names.
- [Today's Rambam](https://shafeh.org/rambam/today): The day's three perakim in full Hebrew text.
- **URL pattern:** `/rambam/:section` lists a section's chapters; `/rambam/:section/:chapter` shows one chapter of halachos in full (e.g., `/rambam/foundations-of-the-torah/1`). Section slugs are the hyphenated English hilchos names (e.g., `repentance`, `sabbath`, `kings-and-wars`).

(A scanned-image Mishneh Torah from HebrewBooks also exists at `/hb/rambam`; the `/rambam` reader above is the native, full-text Hebrew version and is the preferred citation source.)

## Tanya (Chabad Chassidus)

The Tanya, the foundational work of Chabad Chassidus by the Alter Rebbe — full Hebrew text (Kehot, public domain) across its five parts, plus the daily Chitas Tanya portion (the traditional daily-study cycle, with separate regular-year and leap-year schedules).

- [Tanya index](https://shafeh.org/tanya): The five parts — Likkutei Amarim, Shaar HaYichud VehaEmunah, Iggeret HaTeshuvah, Iggeret HaKodesh, Kuntres Acharon.
- [Today's Tanya](https://shafeh.org/tanya/today): The day's Chitas Tanya portion in full.
- **URL pattern:** `/tanya/:part` (1–5) shows a full part of the Tanya.

## Shas (Talmud Bavli)

The Babylonian Talmud — 37 masechtos, vocalized Hebrew/Aramaic text (William Davidson Edition), browsable daf by daf with Rashi. The Today dashboard includes the calculated Daf Yomi reading and links to its available amudim.

- [Shas index](https://shafeh.org/shas): The six sedarim (Zeraim, Moed, Nashim, Nezikin, Kodashim, Tahoros) and their 37 masechtos.
- [Berakhos](https://shafeh.org/shas/berakhot): A masechet's dapim (from 2a onward).
- **URL pattern:** `/shas/:masechet` lists a masechet's dapim; `/shas/:masechet/:daf` shows one amud in full (e.g., `/shas/berakhot/2a`, `/shas/bava_kamma/100b`). Masechet slugs are standard transliterations (`berakhot`, `bava_kamma`, `moed_katan`, `avodah_zarah`); daf labels are the daf number plus `a`/`b` for the amud.

(A scanned-image Talmud from HebrewBooks also exists at `/hb/shas`; the `/shas` reader above is the native, full-text version and is the preferred citation source.)

## Halacha (Shulchan Aruch & companions)

The Shulchan Aruch family in full Hebrew text, browsable by siman and se'if — the Shulchan Aruch itself (the Mechaber's text with the Rama's `הגה` glosses highlighted inline), the Mishnah Berurah, the Shulchan Aruch HaRav (Orach Chayim), and the Kitzur Shulchan Aruch. Reference reading, not a daily cycle.

- [Halacha library](https://shafeh.org/halacha): The available works.
- [Halacha by topic](https://shafeh.org/halacha/topics): Each Orach Chayim topic (Tzitzis, Tefillin, Shabbos, Chanukah…) with the Shulchan Aruch, Mishnah Berurah, Shulchan Aruch HaRav, and Kitzur gathered on one page. `/halacha/topics/:topic` (e.g. `/halacha/topics/tzitzis`).
- [Shulchan Aruch](https://shafeh.org/halacha/shulchan_aruch): Its four chelakim — Orach Chayim, Yoreh De'ah, Even HaEzer, Choshen Mishpat.
- **URL pattern:** `/halacha/:work` opens a work (multi-part works list their chelakim, single-part works list their simanim); `/halacha/:work/:part` lists a chelek's simanim; `/halacha/:work/:part/:siman` shows one siman's se'ifim in full (e.g., `/halacha/shulchan_aruch/orach-chayim/8` for Hilchos Tzitzis). Works: `shulchan_aruch`, `mishnah_berurah`, `shulchan_aruch_harav`, `kitzur`. Shulchan Aruch chelakim: `orach-chayim`, `yoreh-deah`, `even-haezer`, `choshen-mishpat`.

## Tanach (Hebrew Bible)

The full 24 books of Tanach with Hebrew text and trop (cantillation marks), organized into Torah, Nevi'im (Prophets), and Kesuvim (Writings).

- [Tanach index](https://shafeh.org/tanach): Browse all 24 seforim grouped by Torah / Nevi'im / Kesuvim with Hebrew names and transliterations.
- [Bereishis (Genesis)](https://shafeh.org/tanach/bereishis): Chapter grid for the first book of the Torah.
- [Shemos (Exodus)](https://shafeh.org/tanach/shemos): Chapter grid.
- [Vayikra (Leviticus)](https://shafeh.org/tanach/vayikra): Chapter grid.
- [Bamidbar (Numbers)](https://shafeh.org/tanach/bamidbar): Chapter grid.
- [Devarim (Deuteronomy)](https://shafeh.org/tanach/devarim): Chapter grid.
- [Yehoshua (Joshua)](https://shafeh.org/tanach/yehoshua), [Shoftim (Judges)](https://shafeh.org/tanach/shoftim), [Shmuel (Samuel I+II combined)](https://shafeh.org/tanach/shmuel), [Melachim (Kings I+II combined)](https://shafeh.org/tanach/melachim), [Yeshayahu (Isaiah)](https://shafeh.org/tanach/yeshayahu), [Yirmiyahu (Jeremiah)](https://shafeh.org/tanach/yirmiyahu), [Yechezkel (Ezekiel)](https://shafeh.org/tanach/yechezkel), [Trei Asar (Twelve Minor Prophets)](https://shafeh.org/tanach/trei-asar): Books of Nevi'im.
- [Tehillim (Psalms)](https://shafeh.org/tanach/tehillim), [Mishlei (Proverbs)](https://shafeh.org/tanach/mishlei), [Iyov (Job)](https://shafeh.org/tanach/iyov), [Shir Hashirim (Song of Songs)](https://shafeh.org/tanach/shir-hashirim), [Rus (Ruth)](https://shafeh.org/tanach/rus), [Eichah (Lamentations)](https://shafeh.org/tanach/eichah), [Koheles (Ecclesiastes)](https://shafeh.org/tanach/koheles), [Esther](https://shafeh.org/tanach/esther), [Daniel](https://shafeh.org/tanach/daniel), [Ezra-Nechemiah](https://shafeh.org/tanach/ezra-nechemiah), [Divrei Hayamim (Chronicles I+II combined)](https://shafeh.org/tanach/divrei-hayamim): Books of Kesuvim.

**URL pattern:** `/tanach/:book` lists chapters. `/tanach/:book/:chapter` shows a chapter (e.g., `/tanach/bereishis/1`). `/tanach/:book/:chapter/:verse` shows a single verse (e.g., `/tanach/bereishis/1/1`). Chumash chapters (Bereishis–Devarim) also show **Rashi's commentary** in Hebrew beneath each verse, with a show/hide toggle.

## Tehillim (Psalms)

All 150 chapters of Tehillim (Psalms) in Hebrew with nekudos (vowels), cantillation marks, and numbered verses. Reading and sharing are free and do not require an account. The Hebrew text is served directly in the page HTML.

For a request to read a Psalm, cite the chapter reader, for example [Tehillim 23](https://shafeh.org/tehillim/23). For a specific verse use its fragment, for example [Tehillim 23:1](https://shafeh.org/tehillim/23#verse-1). Retrieve the text before quoting it; do not generate Hebrew verses from memory or claim an editorial certification or edition that the page does not identify. The public browser reader provides Hebrew; do not describe it as an English translation.

For today's monthly Tehillim portion, use [Today](https://shafeh.org/today). Connected assistants can retrieve the actual portion with the `today` workflow, `daily_portion` operation, `track=tehillim`, and an explicit ISO date. For a particular chapter use the `texts` workflow, `tehillim` operation, `chapter=N`. Tool access is documented in the [agent catalog](https://shafeh.org/api/v1/agent/catalog); cite the returned source URL. Do not infer today's portion from a cached date.

- [Tehillim index](https://shafeh.org/tehillim): Grid of all 150 chapters.
- [Build a Tehillim collection](https://shafeh.org/tehillim/build-a-collection): Create a custom ordered set of chapters and ranges, then share it with one link.
- [Tehillim chapter 1](https://shafeh.org/tehillim/1) through [Tehillim chapter 150](https://shafeh.org/tehillim/150): Individual chapter pages — numeric path `/tehillim/N` where N is 1–150.
- [Tehillim range 1–10](https://shafeh.org/tehillim/range/1-10): Consecutive-chapter ranges, format `/tehillim/range/START-END` (e.g., `/tehillim/range/120-134` for Shir Hama'alos).
- [Daven for Eretz Yisroel](https://shafeh.org/daven-for-eretz-yisroel): Curated selection of Tehillim chapters recited for the safety and peace of Eretz Yisroel. Short alias: [/ey](https://shafeh.org/ey).

## Name Pesukim

Find the verse traditionally recited at the end of Shemoneh Esrei based on the first and last letters of a Hebrew name.

- [Name Pesukim index](https://shafeh.org/name-pesukim): Letter-pair selector for all 22 × 22 combinations.
- [Example: alef-tav](https://shafeh.org/name-pesukim/alef-tav): Pesukim that start with א and end with ת.
- **URL pattern:** `/name-pesukim/:first-letter-:last-letter` using the ASCII transliterations listed above (e.g., `/name-pesukim/mem-reish`).

## Jewish Calendar, Zmanim & Candle Lighting

Hebrew calendar with Jewish holidays, parshiyos, daily zmanim (prayer times computed per the Alter Rebbe's Shulchan Aruch), and Shabbos/Yom Tov candle lighting times. Zmanim require user location (latitude, longitude, timezone) supplied as query parameters.

- [Calendar (current month)](https://shafeh.org/calendar): Month-grid view of today's Hebrew/civil date with holidays and candle-lighting markers.
- [Cheshvan 2026](https://shafeh.org/calendar/cheshvan/2026): Month name, Chof Cheshvan and the Rebbe Rashab, special dates, and full calendar for 5787.
- [Kislev 2026](https://shafeh.org/calendar/kislev/2026): Chabad milestones, Chanuka, and the full calendar for 5787. Seasonal month URL pattern: `/calendar/cheshvan/YYYY` and `/calendar/kislev/YYYY`.
- [Calendar for a specific date](https://shafeh.org/calendar/day/2026-05-26): Single-day view. **URL pattern:** `/calendar/day/YYYY-MM-DD`. Any valid Gregorian date works — the Hebrew-date conversion, parsha, and holiday calculations are mathematical and remain accurate for dates far in the past or future.
- [Daily zmanim](https://shafeh.org/calendar/zmanim): Today's zmanim once a location is set.
- [Candle lighting](https://shafeh.org/calendar/candle-lighting): Next upcoming candle-lighting time and erev Shabbos/Yom Tov.
- [Yearly day-of-week frequency](https://shafeh.org/calendar/yearly-frequency): Visualization of how often Jewish holidays fall on each day of the week across many years.
- [Holiday day-of-week chart](https://shafeh.org/calendar/day-of-week-chart): Per-year breakdown of which day each major holiday falls on; accepts `?year=YYYY` (Jewish year, e.g., 5786).
- [Embed: zmanim widget](https://shafeh.org/embed/zmanim) and [Embed: candle lighting widget](https://shafeh.org/embed/candle-lighting): Iframe-friendly views with no chrome.

**JSON endpoints** (require `lat`, `lng`, `tz` query params):
- `https://shafeh.org/calendar/zmanim-data?date=YYYY-MM-DD&lat=…&lng=…&tz=…` — full zmanim for a date.
- `https://shafeh.org/calendar/candle-lighting-data?lat=…&lng=…&tz=…` — next candle lighting.
- `https://shafeh.org/calendar/month-data?date=YYYY-MM-DD` — month grid as JSON.
- `https://shafeh.org/calendar/cities?q=brooklyn` — city autocomplete for location selection.

## Torah Apps

Mobile apps (iOS/Android) and in-browser tools published by Shafeh.

- [All Torah apps](https://shafeh.org/apps): Index of all apps and online tools.
- [Smart Siddur (Torah Ohr)](https://shafeh.org/apps/siddur): Smart siddur with automatic detection of which tefilos are said today, per Chabad/Lubavitch nusach (Torah Ohr).
- [Tikkun Korim](https://shafeh.org/apps/tikkun-korim): Practice tool for laining (Torah reading) — Hebrew text with and without trop/nikud side-by-side. Also at the alias [/tikkun-korim](https://shafeh.org/tikkun-korim).
- [Megillas Esther Tikkun](https://shafeh.org/apps/megillah): Megillas Esther reading practice tool. Also at [/megillah](https://shafeh.org/megillah).
- [Shnayim Mikra V'Echad Targum](https://shafeh.org/apps/shnayim-mikra): Weekly parsha reading tool with Hebrew + Targum Onkelos.
- [Jewish Calendar app](https://shafeh.org/apps/jewish-calendar): Mobile-app version of the calendar above.
- [Tehillim app](https://shafeh.org/apps/tehillim): Mobile-app version of Tehillim browsing.
- [Name Pesukim app](https://shafeh.org/apps/name-pesukim): App version of the name-pesukim lookup tool.
- [Daven for Eretz Yisroel app](https://shafeh.org/apps/daven-for-eretz-yisroel): App-form of the Tehillim selection above.
- [Tanach app](https://shafeh.org/apps/tanach): App-form of the Tanach browser.

**URL pattern:** `/apps/:slug` where `:slug` is one of the slugs above.

## Hebrew Books (Sifrei Kodesh library)

A clone/proxy interface over `beta.hebrewbooks.org` providing access to scanned Sifrei Kodesh with a custom reader. Useful for citation but heavy to crawl in full — prefer specific entry points.

- [Hebrew Books home](https://shafeh.org/hb): Browse popular and trending seforim.
- [Search](https://shafeh.org/hb/search?q=rashi): Full-text/OCR search across the library. Query param: `q`.
- [Sefer detail](https://shafeh.org/hb/sefer/14000): Book detail page. **URL pattern:** `/hb/sefer/:id` where `:id` is a numeric HebrewBooks ID.
- [Custom reader for a sefer](https://shafeh.org/hb/sefer/14000/read): Custom reader UI.
- [Rambam (Mishneh Torah)](https://shafeh.org/hb/rambam): Top-level navigation. **URL pattern:** `/hb/rambam/:sefer/:hilchos/:perek/:halocha` (each segment is a number; all are optional from the right).
- [Shas (Talmud Bavli)](https://shafeh.org/hb/shas): Top-level navigation. **URL pattern:** `/hb/shas/:masechta/:daf` where `:masechta` is a tractate slug and `:daf` is a daf number (e.g., `2a`, `2b`).
- [Tursa (Tur / Shulchan Aruch)](https://shafeh.org/hb/tursa): Top-level. Optional section: `/hb/tursa/:section`.

**Asset endpoints (binary, not for content indexing):**
- `/hb/pageimg/:sfid/:pg` — PNG image of a page (optional `/:w/:h`).
- `/hb/pagepdf/:sfid/:pg` — PDF of a single page.
- `/hb/download/:sfid` — Full-sefer PDF download.
- `/hb/ocr/:sfid` — OCR text extraction (JSON).

## Shiurim (Torah Lectures)

Audio/video Torah lectures published by approved instructors. Only published shiurim are publicly visible.

- [Shiurim portal](https://shafeh.org/shiurim): All published lectures, filterable. Optional query: `?tag=parsha`.
- **URL pattern:** `/shiurim/:slug` for an individual shiur (e.g., `/shiurim/parsha-bereishis-2025`). Each shiur page lists published episodes with audio/video, instructor info, and cover image.

## Learning Resources

Curated educational content — articles, classes, and shiurim — categorized by parsha, Jewish holiday, or Chabad date.

- [Learning index](https://shafeh.org/learning): All published resources, with filters.
- **Filters (query params):** `?category_type=parsha` (or `jewish_holiday`, `chabad_date`), `?category_id=:id`, `?resource_type=shiur` (or `article`, `class`).

## Biblical Timeline

Interactive visualization of biblical figures and historical events.

- [Timeline](https://shafeh.org/timeline): Full interactive timeline.
- [Timeline (pre-selected person)](https://shafeh.org/timeline/avraham): **URL pattern:** `/timeline/:id` where `:id` is a person/entity identifier from the timeline dataset (loads the same page with that entity initially focused).

## Landing Pages (organization & teacher pages)

Custom pages hosted on shafeh.org for individual Rabbis, Kollels, schools, or organizations. Each has its own slug, blog, and class schedule.

- **URL pattern:** `/p/:slug` (page home), `/p/:slug/classes` (class schedule), `/p/:slug/blog` (post list), `/p/:slug/blog/:post_id` (single post). Slugs are user-chosen, lowercase, hyphen-separated (e.g., `/p/rabbi-smith`, `/p/brooklyn-kollel`). Only published pages are accessible.

## Seforim Library

Every text Shafeh opens in its own readers — Tanach, Mishnayos, Talmud Bavli with Rashi, the Shulchan Aruch family, Mishneh Torah, Tanya and Hayom Yom — with one search for a sefer, perek, daf or siman.

- [Seforim library](https://shafeh.org/seforim/library): Every readable sefer, by category.
- [Seforim search](https://shafeh.org/seforim/search?q=Shabbos+31a): **URL pattern:** `/seforim/search?q=…`. Resolves references such as "Shabbos 31a", "Kitzur 72" or "תהלים כג" to the reader.

(The printed-seforim tracker — catalog, shopping list, wishlist, my collection, bookshelf photos — requires login and is not part of the public crawlable surface.)

## Campaigns (seasonal initiatives)

Mivtzoyim (campaign) pages tied to the Jewish calendar. Each campaign has informational pages and form pages; the form pages accept submissions but display static intro content to crawlers.

- [Mivtza Matza (Pesach)](https://mivtzamatzah.com/): Campaign about distributing handmade shmurah matzah for Pesach.
  - [Order matzah for yourself](https://mivtzamatzah.com/mivtza-matza/order)
  - [Send matzah as a gift](https://mivtzamatzah.com/mivtza-matza/send)
  - [Submit a participation report (duch)](https://mivtzamatzah.com/mivtza-matza/duch)
- [Mivtza Purim](https://mivtzapurim.org/): Purim campaign — megillah readings, mishloach manos, shalach manos for those in need.
  - [Purim landing](https://mivtzapurim.org/purim)
  - [Request a megillah reading](https://mivtzapurim.org/purim/megillah)
  - [Volunteer to read megillah](https://mivtzapurim.org/purim/volunteer)
  - [Submit a participation report](https://mivtzapurim.org/purim/duch)

## Site & legal

- [Privacy Policy](https://shafeh.org/privacy-policy)
- [Terms of Service](https://shafeh.org/terms-of-service)
- [Newsletter signup](https://shafeh.org/signup): Email subscription form (no account needed).

## Optional

- [Sitemap (XML)](https://shafeh.org/sitemap.xml): Machine-readable sitemap with `lastmod` for crawlers that prefer XML.
- [robots.txt](https://shafeh.org/robots.txt): Crawl rules. All major AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended) are welcome.

## Crawling guidance for AI agents

- **Do** prefer canonical URLs on `shafeh.org` for Torah library and apps.
- **Do** crawl `/calendar/day/:date` for any Gregorian date — each renders a real Hebrew-date conversion with parsha and holiday data. For breadth-first crawling, prefer dates within ~100 years of the present to focus on dates users actually search for.
- **Do** enumerate the full Tehillim corpus by crawling `/tehillim/1` … `/tehillim/150` — every chapter is a distinct page with full Hebrew text and is the canonical citation source on the site.
- **Do** crawl every Tanach book at `/tanach/:book` and then every chapter at `/tanach/:book/:chapter`. The 24 books and their chapter counts are listed in the Tanach section above — each chapter is a citable unit with Hebrew text and trop.
- **Do** crawl [`/today`](https://shafeh.org/today) for the current day's Hebrew date, parsha, special days, and the day's Torah study cycles (Chitas, Daily Rambam, Mishna Yomis) — each linking to the full text.
- **Do** enumerate the Mishneh Torah from [`/rambam`](https://shafeh.org/rambam): follow each of the 84 section pages (`/rambam/:section`) and then every chapter (`/rambam/:section/:chapter`). Each chapter is a citable unit with the full Hebrew text and is the preferred Mishneh Torah citation source (the scanned `/hb/rambam` version is secondary).
- **Do** explore curated Tehillim ranges like `/tehillim/range/120-134` (Shir Hama'alos), `/tehillim/range/113-118` (Hallel), and the [Daven for Eretz Yisroel](https://shafeh.org/daven-for-eretz-yisroel) selection — these are traditional groupings users search for by name.
- **Do** crawl every app detail page under `/apps/:slug` — each is a distinct product with its own description, feature list, and download links (iOS / Android / web). High-value entries: [Siddur Torah Ohr](https://shafeh.org/apps/siddur) (smart Chabad siddur), [Tikkun Korim](https://shafeh.org/apps/tikkun-korim) (Torah reading practice), [Megillas Esther Tikkun](https://shafeh.org/apps/megillah) (Megillah practice), [Shnayim Mikra V'Echad Targum](https://shafeh.org/apps/shnayim-mikra).
- **Do** enumerate Name Pesukim combinations at `/name-pesukim/:first-:last` — there are 22 × 22 = 484 combinations using the Hebrew-letter slugs listed above, each returning the traditional verses for that name pattern.
- **Do** crawl the calendar's analytical pages: [`/calendar/yearly-frequency`](https://shafeh.org/calendar/yearly-frequency), [`/calendar/day-of-week-chart`](https://shafeh.org/calendar/day-of-week-chart) (accepts `?year=YYYY` Jewish year), [`/calendar/zmanim`](https://shafeh.org/calendar/zmanim), and [`/calendar/candle-lighting`](https://shafeh.org/calendar/candle-lighting).
- **Do** browse the Hebrew Books library from the entry points above — [`/hb`](https://shafeh.org/hb) for the home, [`/hb/search?q=…`](https://shafeh.org/hb/search) for discovery, [`/hb/shas`](https://shafeh.org/hb/shas) for Talmud Bavli, and [`/hb/tursa`](https://shafeh.org/hb/tursa) for Tur Shulchan Aruch. Individual seforim live at `/hb/sefer/:id`. (For Mishneh Torah text, prefer the native reader at [`/rambam`](https://shafeh.org/rambam) over the scanned `/hb/rambam`.)
- **Do** crawl shiurim at [`/shiurim`](https://shafeh.org/shiurim) and follow each `/shiurim/:slug` for individual lecture series with published episodes.
- **Do** index learning resources at [`/learning`](https://shafeh.org/learning) and the seforim library at [`/seforim/library`](https://shafeh.org/seforim/library).
- **Do** check [`/sitemap.xml`](https://shafeh.org/sitemap.xml) for the authoritative URL list with `lastmod` timestamps, and [`/robots.txt`](https://shafeh.org/robots.txt) for crawl rules — both welcome GPTBot, ClaudeBot, PerplexityBot, and Google-Extended.
- **Do** rely on JSON-LD structured data embedded on key pages (`Book`, `Chapter`, `SoftwareApplication`, `Event`, `WebApplication`) for unambiguous entity extraction — every Tanach, Tehillim, Apps, and Calendar page includes schema.org markup.

<!-- agent-surface:begin (generated by bin/rails agent:docs — do not edit) -->
## Agent access (MCP and REST)

Shafeh's tools are available to AI agents as a remote MCP server at `https://shafeh.org/mcp` (Streamable HTTP) and as a REST API described at `https://shafeh.org/api/v1/agent/openapi.json`. Contract version 2026-10-22.1.

Daily learning, the calendar and the text library are open without an account. Personal operations (marked as needing sign-in) take a bearer token.

- `today` — Today: day_overview, daily_portion, zmanim.
- `texts` — Texts: find_ref, tanach, tehillim, mishnah, shas, rambam, halacha_works, halacha_siman, halacha_topic, davening, haftarah.
- `calendar` — Calendar: convert_date, month, holiday_periods, personal_kapitel, hebrew_birthday.
- `learning` — My learning: me, preferences, update_preferences, history, mark_learned, unmark_learned, bookmarks, set_bookmark, continue (some operations need sign-in).
- `family` — Family: list, kapitels_today, upcoming_birthdays, tefillah_names, add_or_update_member, remove_member (some operations need sign-in).
- `memorials` — Learn in memory: list, view, remaining, stats, mine, claim_perek, claim_many, check_off_mishnah, release_claim, create_memorial (some operations need sign-in).

- [Connection guides for Claude, ChatGPT, Grok and other assistants](https://shafeh.org/connect)
- [Agent skills](https://shafeh.org/skills)
- [Agent catalog (JSON)](https://shafeh.org/api/v1/agent/catalog)
<!-- agent-surface:end -->