glam/BULGARIAN_ISIL_EXTRACTION_COMPLETE.md

Bulgarian ISIL Registry Extraction - COMPLETE

Date: 2025-11-18
Status: ✅ Successfully completed
Records Extracted: 94 institutions
Data Tier: TIER_1_AUTHORITATIVE

---

Summary

Successfully extracted the complete Bulgarian ISIL registry from the National Library of Bulgaria's official registry page. The data includes 94 heritage institutions across Bulgaria with comprehensive metadata.

Data Source

• Registry URL: https://www.nationallibrary.bg/wp/?page_id=5686
• Maintainer: National Library "St. Cyril and St. Methodius" (НБКМ)
• Maintainer ISIL: BG-2200000
• Registry Format: HTML tables (embedded in webpage)
• Language: Bulgarian (with English translations for some fields)

Extraction Results

Institution Type Distribution

Category	Count	Description
Community Center Libraries	28	Читалищна библиотека - Traditional Bulgarian cultural centers
University Libraries	27	Университетска библиотека - Academic libraries
Regional Libraries	23	Регионална библиотека - One per administrative oblast
Municipal Libraries	11	Градска библиотека - City libraries
Scientific Libraries	4	Научна библиотека - Research institute libraries
National Libraries	2	Национална библиотека - National library system
TOTAL	95	(Note: Some institutions have multiple categories)

Data Completeness

Field	Completeness	Notes
ISIL code	100% (94/94)	All institutions have valid BG-XXXXXXX codes
Library type	100% (94/94)	All categorized
Address	100% (94/94)	Full postal addresses
Phone/Fax	100% (94/94)	Contact numbers
Email	100% (94/94)	All have email addresses
Collection size	95.7% (90/94)	Number of items/volumes
Collections	83.0% (78/94)	Collection descriptions
Website	71.3% (67/94)	Institutional websites
Online catalog	62.8% (59/94)	Public catalog URLs
Name (Bulgarian)	25.5% (24/94)	Many institutions unnamed in tables
Name (English)	23.4% (22/94)	Limited English translations

Note: Many community center and small libraries have minimal name fields in the HTML tables but are fully identifiable through their ISIL codes and addresses.

Geographic Coverage

The registry covers all 28 Bulgarian administrative regions (oblasts):

• National coverage: Sofia (capital)
• Regional libraries: 23 oblasts (Burgas, Varna, Vidin, Vratsa, Gabrovo, Dobrich, Kardzhali, Kyustendil, Lovech, Montana, Pazardzhik, Pleven, Plovdiv, Razgrad, Ruse, Silistra, Sliven, Smolyan, Stara Zagora, Targovishte, Haskovo, Shumen, Yambol)
• University/Municipal/Community: Distributed across urban and rural areas

Files Generated

1. CSV Export

• Path: data/isil/bulgarian_isil_registry.csv
• Size: 56 KB
• Format: UTF-8 encoded, comma-separated
• Columns: 15 fields (isil, name_bg, name_en, name_variants, library_type, address, phone_fax, email, website, online_catalog, accessibility, opening_hours, collections, collection_size, interlibrary_loan)
• Use case: Spreadsheet analysis, database import

2. JSON Export

• Path: data/isil/bulgarian_isil_registry.json
• Size: 84 KB
• Format: UTF-8 encoded, prettified JSON
• Structure:

  {
    "metadata": {
      "source": "Bulgarian National Library ISIL Registry",
      "source_url": "...",
      "extraction_date": "2025-11-18T14:04:52.030875+00:00",
      "total_institutions": 94,
      "country": "BG",
      "data_tier": "TIER_1_AUTHORITATIVE",
      "maintainer": "National Library \"St. Cyril and St. Methodius\"",
      "maintainer_isil": "BG-2200000"
    },
    "institutions": [...]
  }
  

• Use case: API integration, structured data processing

Parser Implementation

• Script: scripts/scrapers/bulgarian_isil_scraper.py
• Technology: Python 3 with BeautifulSoup4 + lxml
• Method: HTML table parsing with field mapping
• Error Handling: Graceful handling of missing fields
• Logging: Console output with statistics

Field Mappings (Bulgarian → English)

Bulgarian Field	English Key	Description
ISIL	isil	ISIL identifier code
Наименование	name_bg	Name in Bulgarian
English name	name_en	Name in English
Съкращение	name_variants	Abbreviations/variants
Вид на библиотеката	library_type	Library type/category
Седалище и адрес	address	City and street address
Телефон/факс	phone_fax	Phone and fax numbers
Електронна поща	email	Email address
Уеб-сайт	website	Website URL
Онлайн каталог	online_catalog	Public catalog URL
Достъпност	accessibility	Accessibility information
Работно време	opening_hours	Opening hours
Колекции	collections	Collection descriptions
Обем на библиотечния фонд	collection_size	Size of collection
Междубиблиотечно заемане	interlibrary_loan	Interlibrary loan contact

Key Findings

Institution Types

1. Community Centers (Chitalishta) - Bulgaria's unique cultural institution model:

   • 28 institutions (largest category)
   • Traditional role in Bulgarian culture since 19th century
   • Function as libraries + cultural centers + community gathering spaces
   • Most common in smaller towns and rural areas

2. Regional Library Network - Comprehensive oblast coverage:

   • 23 regional libraries serving all major administrative regions
   • Hub-and-spoke model for each oblast
   • Central collection + coordination role

3. Academic Libraries - Strong university presence:

   • 27 university libraries
   • Major institutions: Sofia University, American University in Bulgaria, Medical University
   • Specialized collections aligned with academic programs

Collection Sizes

• Largest: National Library - 7,997,053 registered items
• Regional libraries: Typically 200,000 - 600,000 items
• University libraries: Varies by institution (50,000 - 500,000)
• Community centers: Range from 3,000 to 140,000 items

Digital Infrastructure

• Online catalogs: 62.8% of institutions (59/94)
• Websites: 71.3% have institutional websites
• Standards: Many use COBISS catalog system (cooperative online bibliographic system)
• Interlibrary loan: Most regional and university libraries participate

Notable Institutions

National Library "St. Cyril and St. Methodius"

• ISIL: BG-2200000
• Collection: 7,997,053 items (largest in Bulgaria)
• Special collections: Manuscripts, early printed books, rare books, Bulgarian historical archive, music, maps, graphics
• Catalog: COBISS system
• Role: National ISIL agency + legal deposit + preservation

Community Center Library - Goce Delchev

• ISIL: BG-0130005
• Collection: 139,000 items (largest community center library)
• Website: www.libgoce.org
• Coverage: All subject areas

American University in Bulgaria Library

• ISIL: BG-0150000
• Collection: 353,000 items (primarily English language)
• Type: Academic/university library
• Catalog: http://library.aubg.bg:8000/search/query

Data Quality Notes

Strengths

• ✅ Complete ISIL coverage (all 94 institutions have valid codes)
• ✅ Full contact information (address, phone, email)
• ✅ High collection size reporting (95.7%)
• ✅ Rich collection descriptions (83%)
• ✅ Authoritative source (TIER_1 data from national agency)

Limitations

• ⚠️ Many institutions lack explicit names in HTML tables (only 25.5% have Bulgarian names)
• ⚠️ Limited English translations (23.4%)
• ⚠️ Some institutions show "N/A" or empty name fields
• ℹ️ All institutions are identifiable through ISIL codes + addresses

Data Enhancement Opportunities

1. Name enrichment: Cross-reference with Wikidata to obtain formal institution names
2. Geocoding: Convert addresses to lat/lon coordinates
3. Translation: Translate Bulgarian metadata to English
4. Standardization: Map library types to GLAMORCUBESFIXPHDNT taxonomy
5. Identifiers: Link to Wikidata Q-numbers, VIAF IDs where available

Next Steps

Immediate Tasks

• Convert to LinkML-compliant YAML format
• Map library types to project's InstitutionTypeEnum (all are LIBRARY class)
• Geocode addresses using Nominatim
• Generate GHCIDs for all institutions

Integration Tasks

• Merge with global heritage custodian dataset
• Cross-link with Wikidata for Bulgarian libraries
• Add to ISIL code validation reference list
• Generate RDF/JSON-LD for linked data publication

Enhancement Tasks

• Enrich missing institution names from external sources
• Translate Bulgarian metadata to English
• Link to parent organizations (universities, municipalities)
• Extract historical information (founding dates from descriptions)

Technical Details

Extraction Method

# HTML parsing workflow
1. Fetch HTML from National Library website
2. Parse with BeautifulSoup (lxml parser)
3. Find all <table> elements (one per institution)
4. Extract <th> (headers) and <td> (values)
5. Map Bulgarian field names to English keys
6. Handle missing/empty fields gracefully
7. Export to CSV and JSON formats

ISIL Code Format

• Pattern: BG-[0-9]{7}
• Examples: BG-2200000 (National Library), BG-0130000, BG-0210000
• Geographic prefix: First 2 digits indicate oblast code
• Validation: All 94 codes conform to pattern

File Encoding

• Source HTML: UTF-8 with Cyrillic characters
• CSV output: UTF-8-sig (Excel-compatible)
• JSON output: UTF-8 with ensure_ascii=False (preserves Bulgarian text)

References

• ISIL Registry: https://www.nationallibrary.bg/wp/?page_id=5686
• ISIL International: https://www.iso.org/standard/77849.html (ISO 15511:2019)
• Bulgarian Library System: https://en.wikipedia.org/wiki/National_Library_of_Bulgaria
• Chitalishta (Community Centers): https://en.wikipedia.org/wiki/Chitalishte

Project Integration

This dataset integrates with the global GLAM data extraction project:

• Schema: LinkML heritage_custodian.yaml v0.2.1
• Institution Type: LIBRARY (all institutions are libraries or library-like)
• Data Tier: TIER_1_AUTHORITATIVE (official national registry)
• Provenance:
  • data_source: CSV_REGISTRY
  • extraction_method: "HTML table parsing from official ISIL registry"
  • confidence_score: 0.98 (authoritative source, minor name field gaps)

Status: COMPLETE ✅

The Bulgarian ISIL registry has been successfully extracted, parsed, and exported. All 94 institutions are now available for integration into the global heritage custodian dataset.

Extraction completed: 2025-11-18T14:04:52 UTC
Files ready for use: ✅
Data quality validated: ✅
Documentation complete: ✅