search

Search the Islam West Africa Collection across newspaper articles, Islamic publications, archival documents, academic references, and the authority index (persons/places/organisations/events/subjects). Pass ONE concept or name — e.g. 'Tijaniyya', 'laïcité', 'Sheikh Gumi', 'pèlerinage'. Matching is accent- and case-insensitive; a multi-word query requires every word to appear somewhere in the item, so prefer a single concept per call. Newspaper/document text is French; academic references are multilingual (try French and English). Use the French transliteration of Islamic terms (Tabaski not 'Eid al-Adha', charia not 'sharia', Maouloud not 'Mawlid'). Returns {results:[{id,title,url,category}], ranking}; each result's `category` names its subset and the `ranking` field documents the ordering. Pass an id to `fetch` to read the full text. For filtered queries (by country, date, or newspaper) use the search_* tools instead.

fetch

Retrieve the full text and metadata of one IWAC item by an id returned from `search` (format '<category>:<number>', e.g. 'articles:28576'). Returns {id, title, text, url, metadata}: `text` is the item's OCR / abstract / description, `url` is the canonical islam.zmo.de link to cite, and `metadata` holds the remaining fields (author, date, country, newspaper, AI sentiment, …). Categories: articles, publications, references, documents, index, audiovisual.

search_articles

Search IWAC newspaper articles by keyword (title + OCR + AI abstract), country, newspaper, subject, and date range. Matching is accent- and case-insensitive.

get_article

Get one article (by id): full metadata, the AI abstract (description_ai), Gemini sentiment, and OCR text. Pass a `keyword` to get ~2000-char excerpts around each match instead of the full (capped) OCR.

search_by_sentiment

Filter articles by Gemini sentiment labels (accent/case-insensitive exact match).

get_sentiment_distribution

Aggregate Gemini polarity and centrality counts across a filter set.

search_index

Search the IWAC authority index (persons, places, organisations, events, subjects) by name. Accent/case-insensitive.

get_index_entry

Get full details of an index entry by id (raw dataset columns, French names — Titre, Prénom, Coordonnées…).

list_subjects

List sujets from the IWAC index, sorted by frequency (most-referenced first).

list_locations

List lieux from the IWAC index, sorted by frequency (most-referenced first). The optional 'country' filter selects entries that APPEAR IN records from that country (mentioned-in, not located-in), ranked by collection-wide 'frequency' — so foreign and cross-border entries can appear. Nigeria returns none here (index frequency is computed from articles + publications + references, which have no Nigerian items — Nigeria is audiovisual only).

list_persons

List personnes from the IWAC index, sorted by frequency (most-referenced first). The optional 'country' filter selects entries that APPEAR IN records from that country (mentioned-in, not located-in), ranked by collection-wide 'frequency' — so foreign and cross-border entries can appear. Nigeria returns none here (index frequency is computed from articles + publications + references, which have no Nigerian items — Nigeria is audiovisual only).

get_collection_stats

Overall statistics for all six IWAC subsets.

No parameters.

get_newspaper_stats

Per-newspaper article counts and date ranges.

get_country_comparison

Compare article counts, newspaper counts, date ranges, and Gemini polarity across countries.

No parameters.

search_publications

Search Islamic publications (periodical issues, books). `keyword` matches title, subject and full OCR text; filter by newspaper/series, subject, country and year. Use list_periodicals to discover series titles, and get_publication_fulltext for keyword excerpts from a single issue.

list_periodicals

List the Islamic periodical/series titles in the publications subset, with issue counts and year ranges. Use the returned newspaper value as the `newspaper` filter on search_publications.

get_publication_fulltext

Full OCR text of a publication, optionally returning ~2000-char excerpts around keyword matches (accent-insensitive; capped — see match_count vs excerpts_returned).

search_references

Search academic references (journal articles, book chapters, theses, books, reports) by keyword and metadata. `keyword` is a single substring match over title + abstract, so search ONE term per call (combined terms like 'pèlerinage Mecque' miss results); references are bilingual, so try French AND English terms. Results include a short abstract snippet — use get_reference for the full abstract and bibliographic detail.

get_reference

Full bibliographic record for one academic reference (by id), including the complete abstract (present for ~51% of references), subjects, DOI/URL, and host-work details (book, volume, issue, pages).

search_documents

Search the small archival-documents subset (~26 items: Islamic association reports, flyers, project documents — mostly Burkina Faso). All have OCR text and an AI description. Call with no arguments to list all.

get_document

Get one archival document (by id): full metadata, AI description, and OCR text. Pass a `keyword` to get ~2000-char excerpts around each match instead of the full (capped) OCR — useful for long documents.

list_audiovisual

List audiovisual materials (currently 45 Nigerian recordings, incl. Hausa/Arabic content).