Girişim Haritasıİzmir

Yöntem sürümü

Yöntem ve kaynaklar

Yatırım tavsiyesi değildir. Aracılık yok · para akışı yok

Bu katalog kamuya açık kaynaklardan derlenmiş olgusal bilgileri gösterir. Platform pay alım satımına, yatırım turlarına ya da para toplamaya aracılık etmez; firmalar hakkında "yatırım yapın" ya da "yapmayın" yönünde görüş bildirmez.

Bu sürüm ne yapıyor?

İzmir'deki beş teknoloji geliştirme bölgesinin (Teknopark İzmir, Ege Teknopark, Dokuz Eylül Teknopark, İzmir Bilimpark, Bilişim Vadisi İzmir) internet sitelerinde yayımladığı firma listelerini okur. Teknopark dışındaki (bağımsız) şirketleri de üç yoldan bulur: konumu İzmir olan GitHub kuruluş hesapları, İzmir'deki girişim programlarının katılımcı listeleri (İzQ, EGİAD Melekleri) ve "İzmir merkezli" ya da "İzmir'de kurulan" diye anılan şirketlerin geçtiği girişim haberleri (Webrazzi, Egirişim). İzmir Ticaret Odası'nın herkese açık üye sorgusundan teknoloji faaliyet koduyla (NACE) kayıtlı şirketleri de okur. Aynı firmayı farklı kaynaklarda eşleştirir ve her firma için kaynaklı bir profil çıkarır. Her alanın hangi kaynaktan geldiği ve kaynağın hangi tarihte okunduğu profilde görünür.

Hedef, İzmir'deki teknoloji girişimlerinin en az %90'ını listelemektir. Bugün ne kadar yakın olduğumuzu kapsam kestirimi gösterir.

Kaynaklar

KaynakGrupKayıtOkunma tarihi

Toplama kuralları: her sitenin robots.txt dosyasına uyulur, aynı siteye istekler en az 1,5 saniye arayla gönderilir, yalnızca herkese açık sayfalar okunur. Giriş gerektiren alanlara, doğrulama sorularına (CAPTCHA) ve kullanım şartlarının yasakladığı sitelere (ör. LinkedIn) girilmez.

GitHub: resmî GitHub API'siyle yalnız kuruluş hesapları (konumu İzmir) okunur; kişi hesapları, e-posta adresleri ve üye listeleri alınmaz. Topluluk, kulüp, üniversite, öğrenci takımı ve kişisel hesaplar kurallarla ve elle incelemeyle ayıklanır.

Kurumun kendi sitesi: her alan adının yalnız ana sayfası bir kez okunur; başlık, meta açıklama ve sitede verilen kurumsal sosyal medya ve uygulama mağazası bağlantıları alınır. Metinlerden e-posta ve telefon numaraları silinir; kişi profillerine (ör. linkedin.com/in/…) verilen bağlantılar alınmaz.

Logo: listede ve profilde gösterilen logo, kurumun kendi sitesinin ana sayfasında bildirdiği simge dosyasıdır (apple-touch-icon, simge bağlantıları, sitenin yapısal verisindeki logo ya da favicon); her dosya için sitenin robots.txt kuralına uyulur. Logo yalnız firmayı tanıtmak için küçük boyutta gösterilir; marka hakkı sahibindedir. Birden çok sitede aynı olan hazır tema simgeleri kullanılmaz. Logosunun kaldırılmasını isteyen firma profil penceresindeki formu kullanabilir.

Öne çıkanlar ve benzer firmalar: profilin başındaki kısa bakış ve öne çıkanlar, profildeki kaynaklı alanlardan ve katalog içi karşılaştırmalardan (sektördeki ortanca kuruluş yılı, çalışan sayısı bilinen firmaların ortancası, aynı faaliyet kodundaki firma sayısı) kendiliğinden yazılır. Benzer firmalar, firmaların kendi tanımlarındaki ortak terimlerden, faaliyet kodundan ve uzmanlık etiketlerinden hesaplanır; rakip listesi değildir. Bunlar puan, sıralama ya da yatırım tavsiyesi değildir.

Oda sicili: İzmir Ticaret Odası'nın üye sorgusu meslek gruplarına göre (bilişim, bilgisayar ve donanım, elektronik, telekomünikasyon, tıbbi cihaz, mesleki-bilimsel-teknik, e-ticaret) okunur. Yalnız tüzel kişiler (A.Ş., Ltd. Şti.) ve teknoloji sayılan faaliyet kodları (yazılım, veri işleme, Ar-Ge, elektronik, telekomünikasyon, tıbbi cihaz) alınır. Şahıs işletmeleri alınmaz, çünkü unvanları kişi adıdır. Açık adres saklanmaz; adresten yalnız teknoloji bölgesi ipucu çıkarılır.

Arama yöntemleri

Kataloğu besleyen her yöntem aynı sözleşmeyle tanımlanır: ne okuduğu, hangi erişim biçimiyle ve dayanakla (robots.txt, kullanım şartları), hangi alanları aldığı ve bilerek neyi almadığı, hangi parametrelerle ve ne sıklıkla yenilendiği. Her çalışma bir deftere yazılır. Defterde şunlar tutulur: süre, ağdan ya da önbellekten okunan istek sayısı, kaynak başına kayıt sayısı ve bir önceki çalışmaya göre yeni, değişen ve düşen kayıtlar. Vadesi gelen yöntemler besleme hattında yeniden çalışır. Ardından katalog derlenir, testlerden geçer ve yayımlanır.

YöntemErişim ve dayanakAlınmayanlarProfilSon ağ okumasıYenileme

Neleri toplamıyoruz?

Adaylar ve doğrulama

Bir şirket yalnız dijital izde (ör. GitHub) görüldüyse profili “Doğrulama bekliyor” etiketiyle yayımlanır: resmî bir listede (teknopark, program) ya da girişimin kendi beyanında görülene kadar aday sayılır. Aday profiller katalogda ve kapsam kestiriminde yer alır; profil penceresinden sahiplenme ya da kaldırma istenebilir.

Yalnız oda sicilinde görülen şirketler “Yalnız oda sicilinde” etiketi taşır. Bunlar İzmir'de kayıtlı, teknoloji faaliyet kodlu tüzel kişilerdir. Girişim tanımına uydukları başka bir kaynakla doğrulanmadı: yaş, bağımsızlık ve ölçeklenebilir ürün bilinmiyor. İki farklı oda sicil numarası hiçbir zaman tek profilde birleştirilmez.

Elle inceleme kararları (katalogdan çıkarma, hizmet/ajans ya da büyük şirket şubesi işareti) açık bir dosyada tutulur ve her derlemede yeniden uygulanır. İlk inceleme yapay zekâ yardımıyla yapılmıştır; öğrenci ekibinin doğrulamasıyla değişebilir.

Eşleştirme

Aynı firma farklı listelerde farklı adlarla geçebilir. İki kayıt şu durumlarda tek profilde birleşir: aynı alan adını paylaşıyorlarsa ya da unvandan hukuki tür (A.Ş., Ltd. Şti.) ve sondaki jenerik kelimeler (Yazılım, Teknoloji, Sanayi ve Ticaret…) atıldıktan sonra kalan marka adı aynıysa. Profilde görünen ad bu marka adıdır; resmî unvan altında ayrıca yazar. Aynı kurallar unvan eşleştirme API'sinde de kullanılabilir.

Sektör

Sektör, kaynağın kendi sektör alanı, uzmanlık etiketleri, kısa tanım ve kurumun kendi sitesindeki başlık ve meta açıklama üzerinden anahtar kelimelerle otomatik sınıflanır. Hata olabilir; girişim profilini sahiplenerek düzeltebilir.

Veri tamlığı

Veri tamlığı, bir profildeki bilginin ne kadar eksiksiz olduğunu gösterir. Bir kalite, başarı ya da yatırım puanı değildir. Bileşenler:

BileşenAğırlık

Profilde ayrıca yüzdelik sıra görünür: firmanın veri tamlığının, aynı sektördeki profiller arasındaki yeri (100 en dolu). Web sitesi kontrolü her alan adına tek bir istekle yapılır; 2xx ve 3xx yanıt "yanıt veriyor" sayılır.

Teknogirişim Rozeti ön değerlendirmesi

Teknogirişim Rozetini Sanayi ve Teknoloji Bakanlığı verir; bu katalog rozet vermez. Profilde yalnız kamuya açık bilgilerle bir ön değerlendirme görünür. Kapsam hedefinin paydası bu tanımdır:

ÖlçütBu sürümde nasıl bakılıyor?
15 yaştan gençKuruluş yılı biliniyorsa; bilinmiyorsa “bilinmiyor”.
Bağımsız (büyük şirket şubesi değil)Bilinen grup adları ve elle işaret. Unvandaki “Teknopark Şubesi” tek başına şube sayılmaz (girişimler Ar-Ge şubesi açar).
Teknoloji ve yenilik tabanlıSınıflanmış teknoloji sektörü, uzmanlık etiketi ya da GitHub'da kuruluş hesabı.
Ölçeklenebilir iş modeliHizmet/ajans olarak işaretlenen firmalar bu ölçütü karşılamaz sayılır.
KOBİÇalışan ve ciro verisi gelene kadar bilinmiyor; büyük şirket şubeleri hariç.

Sonuç: hiçbir ölçüt açıkça karşılanmıyorsa ve yaş ile teknoloji ölçütleri karşılanıyorsa “tanıma uyuyor”; bir ölçüt açıkça karşılanmıyorsa “tanıma uymuyor”; geri kalanı “bilinmiyor”.

Girişimler kesiti

Katalog İzmir'deki teknoloji firmalarının tamamını tutar; bunların hepsi girişim değildir. Keşfet ekranı varsayılan olarak Girişimler kesitini gösterir (yöntem kesit-v1). Bir firma kesite girer, eğer:

  1. teknopark listesinde, program listesinde, GitHub kuruluş hesaplarında ya da haberde görülmüşse (yalnız oda sicilinde değilse) ya da Teknogirişim Rozeti ön değerlendirmesinde tanıma uyuyorsa;
  2. ve 15 yaşından büyük olduğu bilinmiyorsa (ön değerlendirme “tanıma uymuyor” değilse);
  3. ve büyük şirket şubesi ya da bağlı kuruluşu değilse.

Kesit dışındaki firmalar silinmez; “Tüm teknoloji firmaları” seçeneğinde görünür. Kesit bir değerlendirme değildir: yalnız kayıtlı kaynaklara ve ön değerlendirmeye dayanır. Kuruluş yılı bilinmeyen firmalarda tabloda sicil numarasından kestirilen tescil yılı “≈” işaretiyle görünür.

Yapay zekâ odağı

Her firmanın tek bir sektörü vardır; yapay zekâyı sağlıkta ya da tarımda kullanan bir firma o sektörde sayılır. Bu yüzden “Yapay zekâ ve veri” sektörü ekosistemdeki yapay zekâ çalışmasını olduğundan küçük gösterir. Odak sektörün yanına eklenen ikinci bir işarettir (yöntem odak-v1). Bir firma yapay zekâ odağı alır, eğer:

Yalnız “AI” kısaltması yetmez (firma adında ya da alan adında rastlantıyla geçebilir); “AI destekli”, “AI-powered” gibi açık kullanımlar sayılır. “Görüntü işleme” sanayi otomasyonunda yaygın olduğu için tek başına sayılmaz. Profilde hangi alanda hangi ifadenin geçtiği kanıt olarak gösterilir. Odak, firmanın yapay zekâ ürettiğini değil, kendini bu alanda tanıttığını gösterir; bir değerlendirme değildir.

Liste ve dışa aktarma

Satırdaki ☆ işaretiyle ya da profildeki “Listeme ekle” ile kısa liste yapılır. Liste yalnız sizin tarayıcınızda saklanır; hesap açılmaz, sunucuya gönderilmez. “Paylaşma bağlantısını kopyala” listedeki firmaların kimliklerini bağlantıya yazar; bağlantıyı açan kişi listeyi görür, kendi listesi değişmez. “CSV indir” o anki kümeyi (süzgeçlerle, arama ya da listeyle) Excel'de açılan bir dosyaya yazar: ad, unvan, site, sektör, odak, bölge, kuruluş ya da tescil yılı, doğrulama, rozet ön değerlendirmesi, kaynak sayısı, veri tamlığı, profil adresi ve kaynak adları. Son satırda veri tarihi ve “yatırım tavsiyesi değildir” notu bulunur. Makine okuması için API kullanılabilir.

Kapsam kestirimi

İzmir'de toplam kaç teknoloji girişimi olduğu bilinmiyor. Kestirmek için birbirinden ayrı kaynak grupları karşılaştırılır (yakala–yeniden yakala): teknopark listeleri, GitHub kuruluş hesapları, program listeleri (İzQ, EGİAD Melekleri) ve girişim haberleri. Bir şirketin birden çok grupta görülme sıklığı, hiçbir grupta görülmeyen şirketlerin sayısını kestirmeyi sağlar.

KatmanGruplarYöntemEldeKestirilen toplam (%95 aralık)Kapsama

GitHub yalnız yazılım yapan şirketleri yakalayabildiği için ana kestirim yazılım ve yapay zekâ katmanında yapılır. Program ve haber adları kataloğa yalnız elle inceleme kararıyla girer (İzmir'de olduğu kanıtlanmalı); karar bekleyen adlar katalogda ve kestirimde yoktur.

Veri tazeliği

Profildeki dolu her alan (ad, unvan, web sitesi, uzmanlık etiketi, kısa tanım, kuruluş yılı, konum, oda sicili, site erişimi), o alanı veren kaynağın son okunma tarihiyle eşlenir. Kaynak son 90 günde okunduysa alan doğrulanmış sayılır; hedef, alanların en az %80'inin doğrulanmış olması. Liste ve sicil kaynakları haftalık beslemede yeniden okunur; oda listeleri en geç 84 günde, kurumun kendi sitesinden alınan bilgi en geç 84 günde yenilenir. Haber ve program kaynaklarında tarih yazının tarihidir: bu alanlar yeniden doğrulanmadıkça eskir. Sektör, tescil yılı kestirimi ve Rozet gibi türetilmiş alanlar sayılmaz. Güncel oran kapsam görünümünde ve /api/v1/coverage yanıtının freshness alanında (tazelik-v1).

Değerlendirme skoru

Bu sürümde değerlendirme skoru yok. Sonraki sürümde girişimler profillerini sahiplenip yatırıma hazırlık testini doldurduğunda, skor yalnızca girişimin onayıyla ve bileşenleri ve yöntemiyle birlikte gösterilecek. Harf notu (AAA, BB gibi) kullanılmayacak.

Kişisel veri ve aydınlatma

Kurucular ve ekip. Profillerde kurucu ve kurucu ortakların yalnız adı, rolü ve bilginin alındığı sayfa ile tarihi gösterilir. Bilgi kurumun kendi web sitesinden (ekip ve hakkımızda sayfaları, sitenin yapısal verisi) ya da kurucunun kendi beyanından alınır; telefon, e-posta, fotoğraf ve kişi profili bağlantısı alınmaz. Amaç, girişimlerin kim tarafından kurulduğunu kaynaklı biçimde göstermektir. Hukuki dayanak, bilginin ilgili kişi ya da kurumu tarafından alenileştirilmiş olması ve veri sorumlusunun meşru menfaatidir (6698 sayılı Kanun m. 5/2-d ve 5/2-f). Firmanın çalışan sayısı yalnız sayı olarak gösterilir. Kurumun ekip sayfasındaki öbür çalışanların ad ve unvanı yalnız verinin doğrulanması için platform içinde tutulur; yayımlanmaz, API'de dönmez ve üçüncü kişilere aktarılmaz. Kaynak sayfa yeniden okundukça kayıtlar güncellenir: sayfadan kalkan ad bir sonraki okumada silinir. Veri sorumlusu Muhammed Enes Duran (kurucu), İzmir. Kanun'un 11. maddesindeki haklarınızı (bilgi isteme, düzeltme, silme, itiraz) profil penceresindeki formla ya da iletişim adreslerine yazarak kullanabilirsiniz; itiraz eden kişinin adı bir daha gösterilmez.

Profil sahiplenme, düzeltme ya da kaldırma formunu kullandığınızda e-posta adresiniz, rolünüz ve notunuz yalnızca talebinizi doğrulamak ve sonuçlandırmak için işlenir; üçüncü kişilerle paylaşılmaz. Formun Ekip bölümüne yazdığınız kurucu adları ve çalışan sayısı, talebiniz doğrulanıp onaylanırsa profilde ve API'de "doğrulandı" olarak yayımlanır; onaylanmazsa yayımlanmaz. Adlarını yazdığınız kurucuları bu konuda bilgilendirmeniz gerekir. IP adresiniz saklanmaz: kötüye kullanımı sınırlamak için günlük olarak özetlenmiş (geri çevrilemez) bir değeri tutulur. Talebiniz sonuçlandıktan sonra e-posta adresinizin silinmesini isteyebilirsiniz.

Kurum talep formu. Kurumlar sayfasındaki pilot ve erken erişim formunu kullandığınızda kurum adınız, e-posta adresiniz, rolünüz, isteğe bağlı kişi sayısı ve notunuz yalnızca talebinize yanıt vermek ve hangi kurumların neye ihtiyaç duyduğunu toplu olarak görmek için işlenir; üçüncü kişilerle paylaşılmaz, pazarlama listesine eklenmez. Hukuki dayanak açık rızanızdır (6698 sayılı Kanun m. 5/1). IP adresiniz saklanmaz: kötüye kullanımı sınırlamak için günlük olarak özetlenmiş (geri çevrilemez) bir değeri tutulur. Talebiniz sonuçlandıktan sonra ya da istediğiniz zaman iletişim adreslerine yazarak kaydınızın silinmesini isteyebilirsiniz.

Bir firma profilinin kaldırılmasını ya da düzeltilmesini, profil penceresindeki formdan isteyebilirsiniz.

Kullanım ölçümü. Sitenin nasıl kullanıldığını çerez kullanmadan sayıyoruz (yöntem olcum-v1): hangi sayfanın açıldığı, karşılamada hangi yolun seçildiği, hangi süzgeç türünün kullanıldığı, hangi firma profilinin açıldığı, listeye ekleme ve CSV indirme. Sunucuda yalnız gün, olay ve sayı tutulur. Çerez, kullanıcı kimliği, IP adresi, tarayıcı izi ve arama metni saklanmaz; tek tek ziyaretçi ayırt edilemez. Tarayıcınızda “Do Not Track” ya da “Global Privacy Control” açıksa hiçbir şey gönderilmez. Toplam sayılar /api/v0/olcum adresinde herkese açıktır; firma profili açılışları firma bazında yayımlanmaz.

API

Bütün uçlar, alanlar ve deneme konsolu: API belgesi (OpenAPI 3.1). Kullanım: API kullanım şartları.

Katalog, salt okunur ve ücretsiz bir API ile de erişilebilir. Okuma uçları anahtarsız da çalışır. Hesap uçları (unvan eşleştirme, dijital sinyal, bordro) ve daha yüksek kota için API anahtarı gerekir; anahtar şimdilik elle verilir, kayıt formu sonraki sürümde.

ErişimUçlarKota (UTC gün ve ay)
Anahtarsızv0 ve v1 okuma uçlarıIP başına günde 200 istek
Anahtarlı (ücretsiz plan)Tüm uçlarGünde 1.000, ayda 10.000 birim. Okuma isteği 1 birim; eşleştirmede her unvan ya da çift, bordroda her hesap ya da çizelge ayı 1 birim.

Anahtar Authorization: Bearer gpk_… ya da X-API-Key: gpk_… başlığıyla gönderilir; adres satırında kabul edilmez. Her yanıtta RateLimit-Limit, RateLimit-Remaining ve RateLimit-Reset (gün sonuna saniye), anahtarlı isteklerde ayrıca X-Quota-Month-Remaining başlığı döner. Kota dolunca yanıt 429 ve Retry-After olur. Anahtarın kendisi saklanmaz, yalnız özeti tutulur. Anahtarsız isteklerde IP adresi saklanmaz; kota için günlük tuzla özetlenmiş, ertesi gün silinen bir değer tutulur.

v1, arama yöntemlerini ve çalışma defterini de açar. Firma sorgusunda virgülle ayrılmış değerler aynı süzgeçte “ya da”, farklı süzgeçler “ve” ile birleşir.

Uç nokta (v1)Açıklama
GET /api/v1/companies?q=&sector=&zone=&district=&stage=&verification=&rozet=&group=&method=&source=&nace=&has=&minCompleteness=&sort=&facets=1Genişletilmiş sorgu. verification: listed, candidate, registry. group: teknopark, dijital, program, haber, sicil. nace: kod öneki (ör. 62,63.1). has: website, github, founded, siteActive, registry ve diğerleri. sort: name, completeness, founded, sources; başına - konursa ters sıralanır. facets=1 süzülmüş kümenin dağılımlarını da döner.
GET /api/v1/companies/{id}Tek profil; her kaynağın yöntemi ve grubu, sicil kimlikleri
GET /api/v1/methods, /methods/{id}Arama yöntemleri: erişim ve dayanak, alınan ve alınmayan alanlar, parametreler, vade, verim, son 20 çalışma
GET /api/v1/runs?method=&status=Çalışma defteri: süre, istek sayısı, yeni, değişen ve düşen kayıtlar
GET /api/v1/sources, /coverage, /facetsKaynaklar, kapsam kestirimi, katalog geneli dağılımlar
POST /api/v1/match/normalizeUnvan → marka adı, hukuki tür, marka anahtarı, tam unvan anahtarı. Tek istekte en fazla 50 unvan. Anahtar ister.
POST /api/v1/match/pairİki kayıt → eşleşme kararı, kural puanı ve gerekçe. Tek istekte en fazla 20 çift. Anahtar ister.
GET /api/v1/signals/{alan-adı}, POST /api/v1/signalsDijital sinyal: site erişimi, teknolojiler (içerik yönetimi, e-ticaret, ön yüz çatısı, analitik, canlı destek, ödeme, barındırma), ürün sinyalleri (fiyatlandırma, uygulamaya giriş, deneme/demo, API belgesi), uygulama mağazası ve kurumsal sosyal hesaplar. Toplu istekte en fazla 50 alan adı; her alan adı bir birim. Anahtar ister. Yalnız katalogdaki firmalar; istek üzerine siteye gidilmez.
GET /api/v1/payroll/rules?period=Bordro ve mevzuat kuralları: asgari ücret, SGK oranları ve sınırları, gelir vergisi tarifesi, istisnalar, Ar-Ge teşvikleri. Her kural kaynağı ve doğrulama durumuyla. Anahtarsız.
POST /api/v1/payroll/calculateAylık bordro, brütten nete ya da netten brüte: SGK ve işsizlik kesintileri, kümülatif matrahla gelir vergisi, asgari ücret istisnası, damga vergisi, işveren maliyeti. Tek istekte en fazla 20 hesap; her hesap bir birim. Anahtar ister.
POST /api/v1/payroll/scheduleYıllık çizelge: her ay aynı brüt ya da aynı net için ay ay bordro ve yıl toplamları. Her ay bir birim. Anahtar ister.

Unvan eşleştirme. Katalogu kuran eşleştirme kuralları dışarıya açılır: kendi müşteri ya da tedarikçi listenizi oda sicili ve teknopark kayıtlarıyla aynı kurallarla birleştirebilirsiniz. İstek gövdesi kaydedilmez; yalnız anahtar başına birim sayılır. Katalogda arama yapılmaz, yalnız gönderdiğiniz kayıtlar karşılaştırılır.

normalize her unvan için şunları döner: brand (profilde görünen marka adı; şube eki atılır), legalForm (A.Ş., Ltd. Şti. ya da boş), brandKey (marka adının katlanmış, boşluksuz hali; İngilizce jenerik ekler de atılır), legalKey (hukuki tür ve “sanayi ve ticaret” kalıpları dışındaki tam unvan), branch (şube unvanı mı) ve usable (anahtarın eşleştirmede kullanılacak kadar uzun olup olmadığı).

pair kaydında alanlar: name, legalName, website, chamber ve odaSicil (oda belirtilmezse İZTO sayılır). Karar, katalogu derleyen hattın kendisinden alınır; puan kuralın gücünü gösterir, olasılık değildir.

KuralPuanKoşul
registry100Aynı odada aynı sicil numarası: aynı tüzel kişi.
domain95Aynı alan adı (sosyal ağ ve barındırma adresleri sayılmaz).
legalKey90İki unvanda da hukuki tür var ve tam unvan anahtarı aynı (en az 8 karakter).
brandKey85 / 75Marka anahtarı aynı: en az 4 karakter, kayıtlardan biri oda sicilinden geliyorsa en az 5. Dört karakterlik anahtar 75 puan.
branch92İki farklı sicil kaydı aynı tüzel kişinin merkezi ve şubesi (ya da iki şubesi): hukuki türden sonrası atılmış çekirdek unvan aynı, ikisi birden merkez değil. Şube ayrı tüzel kişi değildir. Katalogda bu kayıtlar tek profilde sicil birimi olarak durur.
prefix70Sicil dışındaki kaydın adı (en az 8 karakter) sicil kaydının unvanının öneki: "Navixus Marine" ↔ "Navixus Marine Gemi Yat Tasarımı … Ltd. Şti.". Katalogda ek şart: önek bütün sicilde tek bir tüzel kişiye uymalı ve o tüzel kişi başka bir kayıtla birleşmemiş olmalı. pair katalogu sınamadığı için puan düşük.
acronym65Ad unvanın ilk sözcüğü, alan adı ilk sözcük ve sonraki sözcüklerin baş harfleri: "YADA", yadabt.com ↔ "Yada Bilgi Teknolojileri A.Ş.". Katalogdaki ek şart prefix ile aynı.
Engel0İki farklı oda sicili iki farklı tüzel kişidir; ad ya da alan adı tutsa da birleşmez. Oda numaraları odaya özgüdür: başka odadaki aynı numara başka firmadır. İstisna, aynı tüzel kişinin merkez ve şube kayıtlarıdır (aşağıda branch). Derleme hattının diğer engelleri de (ör. hukuki türü belli iki unvanın farklı tüzel kişileri anlatması) gerekçede block olarak yazılır. Hukuki türleri farklı iki unvan (A.Ş. ↔ Ltd. Şti.) yalnız tür değişikliğiyse aynı kişidir: unvanın geri kalanı aynı kalmalı.

Birden çok kural tutarsa her ek kural 3 puan ekler (en çok 99). İki kaydın alan adı farklıysa puan 10 düşer, karar değişmez. Eşleşmeyen çiftte aynı ama kısa bir anahtar varsa puan 40 (marka) ya da 50 (tam unvan) olur ve gerekçede weak olarak görünür. Katalog derlemesi ayrıca geçişlidir (A ile B, B ile C eşleşirse üçü bir profil olur); pair yalnız iki kaydı karşılaştırır.

curl -X POST https://izmir-girisim-haritasi.founderexe.workers.dev/api/v1/match/normalize \
  -H "Authorization: Bearer gpk_…" -H "content-type: application/json" \
  -d '{"names": ["Aegean AI Core Yazılım ve Teknoloji Ltd. Şti.", "BPM BİLİŞİM ANONİM ŞİRKETİ"]}'
{"count": 2, "units": 2, "items": [
  {"input": "Aegean AI Core Yazılım ve Teknoloji Ltd. Şti.", "brand": "Aegean AI Core", "legalForm": "Ltd. Şti.",
   "brandKey": "aegeanaicore", "legalKey": "aegeanaicoreyazilimteknoloji", "branch": false,
   "usable": {"brandKey": true, "brandKeyRegistry": true, "legalKey": true}},
  {"input": "BPM BİLİŞİM ANONİM ŞİRKETİ", "brand": "Bpm", "legalForm": "A.Ş.", "brandKey": "bpm", "legalKey": "bpmbilisim", …}],
 "matchVersion": "match-v1.2", "methodVersion": "v0.1", "notice": "…"}
curl -X POST https://izmir-girisim-haritasi.founderexe.workers.dev/api/v1/match/pair \
  -H "X-API-Key: gpk_…" -H "content-type: application/json" \
  -d '{"pairs": [{"a": {"name": "BPM", "legalName": "Bpm Bilişim A.Ş."},
                 "b": {"legalName": "BPM BİLİŞİM ANONİM ŞİRKETİ", "chamber": "İZTO", "odaSicil": "12345"}}]}'
{"count": 1, "units": 1, "items": [{"match": true, "score": 90, "rule": "legalKey", "reasons": [
  {"rule": "legalKey", "outcome": "match", "value": "bpmbilisim", "text": "Aynı tam unvan (…)."},
  {"rule": "brandKey", "outcome": "weak", "value": "bpm", "text": "Marka anahtarı aynı ama kısa (3 < 5, sicil kaydında) …"}]}], …}

Dijital sinyal. Katalogdaki bir firmanın kendi ana sayfasından okunmuş sinyaller: site yanıt veriyor mu, hangi teknolojiler kullanılıyor, fiyatlandırma, uygulamaya giriş, deneme ya da API belgesi gibi ürün sinyalleri var mı. Ana sayfa en çok 90 günde bir, robots.txt'e uyularak okunur; istek üzerine siteye gidilmez, sayfa metni saklanmaz. WordPress yönetim girişi ve tanıtım sayfası yolları ürün sinyali sayılmaz; e-ticaret sitesindeki giriş ve kayıt müşteri hesabı sayılır, ürün kanıtı sayılmaz.

curl -X POST https://izmir-girisim-haritasi.founderexe.workers.dev/api/v1/signals \
  -H "Authorization: Bearer gpk_…" -H "content-type: application/json" \
  -d '{"domains": ["ornek.com.tr", "https://www.baska-firma.com/"]}'
{"count": 2, "units": 2, "found": 1, "items": [
  {"domain": "ornek.com.tr", "found": true, "companies": [{"id": "ornek", "site": {"ok": true, "status": 200, …},
    "tech": [{"id": "wordpress", "label": "WordPress", "cat": "cms"}, …],
    "product": {"pricing": "/fiyatlar", "login": "//app.ornek.com.tr"}, "productEvidence": ["fiyatlandırma sayfası", "uygulamaya giriş"], …}]},
  {"domain": "baska-firma.com", "found": false, "companies": []}], "signalVersion": "sinyal-v0.1", …}

Bordro ve mevzuat. 2026 kurallarıyla, 4/a kapsamında tam ay çalışan biri için aylık bordro. Gelir vergisi kümülatif matrahla hesaplanır; önceki matrah (priorTaxBase) verilmezse çalışanın işe başladığı aydan (startMonth) beri her ay aynı tutarı aldığı varsayılır ve yanıtta yazılır. Seçenekler: incentive (5510 m. 81/1-ı Hazine prim desteği: general 2 puan, manufacturing imalat için 5 puan), disability (engellilik derecesi 1–3) ve rnd (Ar-Ge: teknoloji geliştirme bölgesi için {"law": "4691"}, Ar-Ge ve tasarım merkezi için {"law": "5746", "education": "phd"}; education phd, masters, bachelors ya da other, desteklenecek program alanındaki derece için "priorityField": true).

Her kural /payroll/rules yanıtında kaynağı ve durumuyla durur: dogrulandi (resmî yayında okundu), ikincil (birbirini tutan ikincil kaynaklar) ya da yorum (kural metni okundu, uygulama ayrıntısı mali müşavir doğrulaması bekliyor; şimdilik yalnız Ar-Ge sigorta primi desteği). Hesap, resmî örneklerle sınanır: GİB'in asgari ücret tablosu ve 331 Seri No.lu Gelir Vergisi Genel Tebliği'nin Ar-Ge hesap örnekleri kuruşu kuruşuna tutar. Ar-Ge gelir vergisi teşviki çalışandan kesilen vergiden işverence terkin edilir; çalışanın netini değil işveren maliyetini düşürür. Kapsam dışı: kısmi ay, emekli çalışan (SGDP), birden çok işveren, yemek ve yol yardımı, BES, kıdem tazminatı. Sonuç bilgi amaçlıdır; bordro ya da vergi danışmanlığı değildir.

curl -X POST https://izmir-girisim-haritasi.founderexe.workers.dev/api/v1/payroll/calculate \
  -H "Authorization: Bearer gpk_…" -H "content-type: application/json" \
  -d '{"items": [{"period": "2026-10", "gross": 100000, "incentive": "general"}]}'
{"count": 1, "units": 1, "items": [{"period": "2026-10",
  "employee": {"gross": 100000, "sgk": 14000, "unemployment": 1000, "taxBase": 85000, "priorTaxBase": 765000,
    "marginalRatePct": 27, "incomeTaxCalculated": 22950, "minWageExemption": 5615.1, "incomeTax": 17334.9,
    "stampTax": 508.3, "net": 67156.8, …},
  "employer": {"sgk": 21750, "unemployment": 2000, "incentive5510": 2000, "cost": 121750, …},
  "assumptions": ["…", "Önceki matrah verilmedi: 1. aydan beri her ay aynı brüt ödendiği varsayıldı (kümülatif matrah 765.000,00 TL).", …]}],
 "bordroVersion": "bordro-v1", "rulesChecked": "2026-10-19", "notice": "…"}
Uç nokta (v0, değişmez)Açıklama
GET /api/v0Sürüm, uç noktalar, uyarı metni
GET /api/v0/companies?q=&sector=&zone=&stage=&verification=&sort=&limit=&offset=Süzülmüş liste (en fazla 500 kayıt). stage: yerleşik, kuluçka, bağımsız; verification: listed, candidate; sort: name, completeness, founded
GET /api/v0/companies/{id}Tek profil: alanlar, kaynaklar, alan bazında kaynak kaydı, veri tamlığı bileşenleri
GET /api/v0/statsToplamlar, sektör, bölge ve Rozet dağılımı, kapsam kestirimi, kaynaklar

Sürüm günlüğü