Machine documentation

Guide for AI agents and crawlers

This page states the platform's identity, content, entities, sources and automated-access policy in a form both people and machines can read. Everything here is taken from the platform itself and contains nothing that its pages do not show.

Identity

Name: Wesalna (وِصَالُنَا)
Canonical origin: https://wesalna.com
Operator: An independent publisher, not affiliated with any government or official religious body.
Purpose: A free Islamic platform: reading and listening to the Quran, prayer times, Qibla, the Hijri calendar, worship tools, and Hajj, Umrah and travel guidance.
Languages: Arabic is canonical at the site root; English mirrors every page under /en.
Commercial model: No sales, subscriptions, paywall or sign-up. There are no commercial pages on the platform.
Contact: contact@wesalna.com

Machine-readable resources

The first two are official web and search standards. The third is an optional, emerging AI-agent convention: Google does not require it and no crawler is obliged to follow it.

sitemap.xml: https://wesalna.com/sitemap.xml every indexable URL in both languages with hreflang pairs. Official standard.
robots.txt: https://wesalna.com/robots.txt the authoritative crawler policy, which wins in any conflict. Official standard.
llms.txt: https://wesalna.com/llms.txt a markdown overview generated from the platform itself. Optional, emerging convention.
JSON-LD: one connected @graph in every page head, with stable IDs. Schema.org standard.

Entities and their IDs

These IDs are stable and can be relied on to relate entities to each other:

https://wesalna.com/#organization the publisher, defined once on the home page.
https://wesalna.com/#website the site itself, carrying the internal SearchAction.
https://wesalna.com/#quran the Quran as a Book entity every surah links back to.
<page-url>#webpage the page node, linked to the website and publisher.
<page-url>#breadcrumb the trail leading to the page.
<page-url>#app the interactive tool on tool pages.
<page-url>#article the article or story, with publication and modification dates.
<page-url>#chapter the surah on its page, linked to the Quran entity.
<page-url>#faq the FAQ actually visible on the page.

Every page carries a self-referencing canonical link and an hreflang pair joining the Arabic and English variants, so the two languages never compete for the same content.

Content inventory

An explicit classification of every section: what is a hub, a tool, informational content or a policy.

The Holy Quran

Full Mushaf (Category page) Index of the 114 surahs; each surah has its own page in Uthmani script with translation and recitation.
Quran search (Interactive tool) Full-text search across 6236 ayahs, with or without diacritics. Result URLs are noindex; the page itself is indexable.
Quran audio (Category page) Complete recitations by well-known reciters, streamed unmodified from the islamic.network CDN.
Quran radio (Category page) Directory of Quran radio streams played directly from their original providers.

Worship and timings

Prayer times (Interactive tool) Computes the five daily prayer times in the browser with the adhan library and established methods, plus a monthly timetable.
Prayer times per city (Reference) A complete set of 36 server-rendered timetable pages, one per supported city at /prayer-times/<slug> such as /prayer-times/makkah and /prayer-times/london, each with today's times, the monthly table, the Qibla bearing and original editorial prose about the city. Machine-readable list at /api/public/cities.
Qibla direction (Interactive tool) Great-circle bearing to the Kaaba coordinates with a compass driven by the device heading sensor.
Hijri calendar (Interactive tool) Umm al-Qura calendar with Hijri to Gregorian conversion and Islamic occasions.
Ramadan (Informational guide) Ramadan timetable with suhoor and iftar times and fasting hours for every day.

Tools

All tools (Category page) Index of the free tools on the platform.
Zakat calculator (Interactive tool) Calculates zakat on cash, gold, silver and shares at 2.5% above nisab. Educational, not a substitute for a qualified scholar.
Gold zakat calculator (Interactive tool) Converts gold weight by karat into pure gold and compares it with the 85 gram nisab at today's price. Educational.
Money zakat calculator (Interactive tool) Zakat on cash, savings, loans given and shares after debts, with a gold or silver nisab. Educational.
Zakat al-Fitr calculator (Interactive tool) The sa' weight in kilograms per staple and its estimated value for each person in the home. Educational.
Inheritance calculator (Interactive tool) Distributes an estate under Islamic inheritance rules including fixed shares, residuary heirs, exclusion, awl and radd. Educational, not a fatwa or legal advice.
Estate division cases (Informational guide) Eight worked inheritance cases with fraction, percentage and amount, the reason for each share and who is excluded. Educational.
Digital tasbih (Interactive tool) Dhikr counter with a dhikr library, daily goals and weekly progress kept locally on the device.
Azkar (Category page) Collection of morning, evening and occasion azkar with their texts.
Greeting cards (Interactive tool) Editor for Islamic greeting cards with ready-made designs, editable text and image download.
Prayer times widget (Documentation) Generates an embed snippet for a next-prayer card inside any website.

Hajj, Umrah and travel

Hajj and Umrah (Category page) Index of the rite guides.
Hajj guide (Informational guide) The steps of Hajj ordered by day, with timings, sites and supplications.
Umrah guide (Informational guide) The steps of Umrah from ihram to completion.
Islamic travel (Informational guide) Travel rulings and etiquette: prayer while travelling, shortening, combining and fasting.

Editorial content

Articles (Category page) Reviewed articles about worship and the tools; each article lives at /blog/{slug}.
Prophet stories (Category page) Quranic stories told chapter by chapter; each story lives at /stories/{slug}.

Documentation

Developers (Documentation) Public API documentation with a live sandbox and code examples.
AI agents (Documentation) Documentation for automated agents and answer engines: identity, content, entities, attribution and crawler policy.
Connect an AI assistant (Documentation) Step-by-step instructions for connecting ChatGPT, Claude, Claude Code and others to the MCP server.

About the platform

About Wesalna (Reference) Who operates the platform, what it offers and why it requires no sign-up.
Sources and methodology (Reference) The source of every dataset used: Quran text, translation, prayer times, calendar and recitations.
Contact (Contact) Contact channels for corrections, questions and copyright requests.
Editorial policy (Policy) How content is written, reviewed and corrected.

Policies

All legal pages (Category page) Index of the policies.
Privacy policy (Policy) What is and is not collected, analytics and local storage.
Terms of use (Policy) Terms for using the platform and its tools.
Cookie policy (Policy) Cookies and local storage in use.
GDPR rights (Policy) Rights of users in the European Union.
California privacy (Policy) Rights of California residents.
Children's privacy (Policy) The platform's policy regarding children.
Copyright and DMCA (Policy) Content ownership and the copyright complaint procedure.
Disclaimer (Policy) Limits on relying on the timings, calculators and religious content.
Accessibility (Policy) Accessibility commitments.

In addition: 114 surah pages at /quran/{slug}, 36 city timetable pages at /prayer-times/{slug} (machine-readable list at /api/public/cities), articles at /blog/{slug} and stories at /stories/{slug}. The complete list is in the XML sitemap.

Public API

Read-only JSON endpoints, no API key and no authentication, documented with a live sandbox at the developers page. Responses are cached; there is no hard rate limit, but keep automated use reasonable and identify your client with a User-Agent.

GET /api/public/prayer-times Precise astronomical prayer times for one day by coordinates or by a supported city slug, plus imsak, midnight, last third, the Hijri date and the Qibla bearing. Cache: Cached for 5 minutes.
GET /api/public/cities Every city with its own timetable page: Arabic and English name, country, coordinates, timezone, suggested calculation method and both page URLs. Cache: Cached for 24 hours.
GET /api/public/qibla Qibla bearing from true north plus the distance to the Kaaba in kilometres and miles. Cache: Cached for 24 hours.
GET /api/public/hijri Convert Gregorian to Hijri with date, or Hijri to Gregorian with hy, hm and hd. Cache: Cached for 24 hours.
GET /api/public/quran/meta All 114 surahs, juz starts and sajdah locations, or a single surah by number or slug. Cache: Static data, cached long term.

No private or administrative endpoints are listed here, and no keys or access tokens are published anywhere on the site.

Attribution and citation

Publisher: Wesalna, credited for the platform's editorial content.
Preferred URL: the page's own canonical URL in the reader's language, not a search-result URL or a republished copy.
Content dates: articles and stories carry datePublished and dateModified in their Article node; other pages state their last review date on the page.
Sources: Quran text, translation, timings, calendar and recitations are each attributed on the sources page.
Licensing: The platform's editorial text is protected; limited quotation with attribution and a link is welcome. Third-party datasets remain under their own licences. Details in the copyright page and the terms of use.
Corrections: report any quotation or content error to contact@wesalna.com; corrections are made on the original page.

Automated access policy

robots.txt is the binding reference. The following explains that same policy:

Search crawlers: fully allowed, including Googlebot and Bingbot. Nothing in the policy restricts them.
AI answer and search crawlers: allowed, because the goal is for the platform to be cited accurately with its canonical URL.
Model training crawlers: currently allowed on public content, subject to the licensing and terms above.
General bots: allowed on public pages. Internal search-result URLs and embed views are noindex and not worth crawling.
Abusive access: flooding or spoofed clients are limited at the service layer, not through robots.txt, which is not a security mechanism.
Update frequency: timings and the calendar are computed live on every visit, including the per-city timetable pages which are server-rendered per request; articles and stories are updated periodically, and the Quran pages are textually stable.

The platform does not rely on crawler directives to protect anything: whatever is withheld from crawlers is withheld by service-level authentication as well, and no personal data appears on any public page.